Member Liquid variables

Member storefront is in a limited pilot. Confirm that it is enabled for your company before using these variables. The sign-in and sign-out links described here require the updated storefront authentication release.

Use member for profile fields and member_content for media, content pages, and playlists. Use member_routes for navigation and authentication links, and settings.menu for the current member site’s navigation.

Where variables are available

Variable	Live, authorized member page	Cached storefront page
`member`	Signed-in member’s approved profile fields	Not available
`member_content`	Content visible to the signed-in member	Not available
`member_routes`	Root, sign-in, and sign-out links	Root, sign-in, and sign-out links
`settings.menu`	Resolved member site menu	Normal theme settings

Guests are redirected to hosted authentication before a protected member page renders. There is no themed sign-in landing. Signing in on a storefront does not put private member data into its cached Liquid render. Use Member-aware sections for browser-side personalization there. Builder previews do not expose a real member’s private data, even when you select a preview audience. Member page access rules still apply. Reading a variable does not grant access to another member’s content or another site’s pages.

Member profile

Field	Value
`member.first_name`	Given name
`member.last_name`	Family name
`member.full_name`	Nonempty first and last names joined with a space
`member.email`	Email address for the membership in this company
`member.status`	Activity status in this company
`member.avatar_url`	Profile image URL, when available
`member.bio`	Profile biography, when available
`member.language_iso`	Saved member language code, when available; no company-language fallback
`member.member_type.slug`	Member type slug, when a type is assigned
`member.member_type.name`	Member type display name, when a type is assigned

Read these fields for display. They do not expose permissions, passwords, authentication tokens, or payment-card details. Fields without a value render empty.

{% if member %}
  <header class="member-profile">
    {% if member.avatar_url != blank %}
      <img src="{{ member.avatar_url | escape }}" alt="" />
    {% endif %}
    <h1>Hello, {{ member.first_name | default: member.full_name | escape }}</h1>
    <p>{{ member.member_type.name | escape }}</p>
  </header>
{% endif %}

Lazy content collections

Collection	Content
`member_content.media`	Published media visible to the member in the current country
`member_content.pages`	Published company content pages available in the current country
`member_content.playlists`	Active company-wide playlists and playlists belonging to the member
`playlist.entries`	Visible media and content-page entries in a playlist

member_content.pages is the company’s content library. It is not the list of custom member pages created in the builder. Use settings.menu to navigate the member site. Collections load independently. Assigning a collection to a Liquid variable does not load it. Reading its items, size, empty state, first or last item, navigation links, or error loads one bounded batch. Repeated reads reuse that result during the same render. A playlist’s entries load only when you consume that entries collection. Profile fields also load when you read them. Render individual fields or loop through items. Printing a collection directly does not display its records. Serializing a whole profile reads all its exposed fields, so prefer the fields your section actually needs.

Collection fields

Field	Value
`items`	Items in the current batch
`size`	Number of items in this batch, not a total count
`empty`	Whether this batch has no items
`first`, `last`	First or last item in this batch, or empty
`next_url`, `previous_url`	Relative navigation link, or empty when unavailable
`error`	Empty on success; `invalid_pagination` or `unavailable` on failure

A failed collection returns no items. Check error separately so you do not present a loading failure as an empty library.

Media fields

Field	Value
`id`	Media identifier
`title`	Localized title
`content_format`	Media kind, such as `video`, `image`, `pdf`, `ppt`, or `link`
`url`	Source file or destination URL, when supported
`thumbnail_url`	Thumbnail URL, when available

Reading url does not create a tracked share link. Not every media item has a URL or thumbnail; check before rendering them.

{% if member_content %}
  {% assign library = member_content.media %}
  <section class="member-media">
    <h2>Media library</h2>
    {% if library.error %}
      <p>Media could not be loaded. Please try again.</p>
    {% elsif library.empty %}
      <p>No media is available yet.</p>
    {% else %}
      <ul class="member-media__grid">
        {% for media in library.items %}
          <li>
            {% if media.thumbnail_url != blank %}
              <img src="{{ media.thumbnail_url | escape }}" alt="" loading="lazy" />
            {% endif %}
            {% if media.url != blank %}
              <a href="{{ media.url | escape }}">{{ media.title | escape }}</a>
            {% else %}
              <span>{{ media.title | escape }}</span>
            {% endif %}
          </li>
        {% endfor %}
      </ul>
      <nav aria-label="Media navigation">
        {% if library.previous_url %}
          <a href="{{ library.previous_url | escape }}">Previous</a>
        {% endif %}
        {% if library.next_url %}
          <a href="{{ library.next_url | escape }}">Next</a>
        {% endif %}
      </nav>
    {% endif %}
  </section>
{% endif %}

Place this markup inside your theme’s section and use its existing settings and CSS. The variables do not impose a layout, component, or style.

Content page fields

Field	Value
`id`	Content page identifier
`title`	Localized title
`slug`	Content page slug
`description`	Localized description, when available
`image_url`	Image URL, when available

This projection exposes metadata. It does not expose the page body or a url field. Do not turn its slug into a member-site /pages/ link: those are different resources.

Playlist fields

Field	Value
`id`	Playlist identifier
`title`	Playlist title
`description`	Description, when available
`image_url`	Stored cover image, when available
`entries`	Lazy collection of the playlist’s visible entries

The cover does not fall back to a child item’s image. A playlist does not expose a direct url field.

Playlist entry fields

Field	Value
`id`	Entry identifier
`content_type`	`media` or `page`
`position`	Stored position, when assigned
`content`	The corresponding media or content-page fields listed above

Entries retain their stored order and exclude content the member cannot view. Other entry types are not exposed.

{% if member_content %}
  {% assign playlists = member_content.playlists %}
  {% if playlists.error %}
    <p>Playlists could not be loaded.</p>
  {% else %}
    {% for playlist in playlists.items %}
      <section>
        <h2>{{ playlist.title | escape }}</h2>
        {% assign entries = playlist.entries %}
        {% if entries.error %}
          <p>This playlist could not be loaded.</p>
        {% else %}
          <ul>
            {% for entry in entries.items %}
              <li>
                {% if entry.content_type == 'media' and entry.content.url != blank %}
                  <a href="{{ entry.content.url | escape }}">{{ entry.content.title | escape }}</a>
                {% else %}
                  {{ entry.content.title | escape }}
                {% endif %}
              </li>
            {% endfor %}
          </ul>
          {% if entries.next_url %}
            <a href="{{ entries.next_url | escape }}">More entries</a>
          {% endif %}
        {% endif %}
      </section>
    {% endfor %}
    {% if playlists.next_url %}
      <a href="{{ playlists.next_url | escape }}">More playlists</a>
    {% endif %}
  {% endif %}
{% endif %}

Navigate collections

Use each collection’s generated next_url and previous_url. The default batch size is 25 and the maximum is 100. Navigation uses simple numeric query values for these Liquid collections; this is separate from REST API pagination.

Collection	Batch number	Batch size
Media	`member_media_page`	`member_media_limit`
Content pages	`member_content_pages_page`	`member_content_pages_limit`
Playlists	`member_playlists_page`	`member_playlists_limit`
Playlist entries	`member_playlist_entries_page`	`member_playlist_entries_limit`

For example, ?member_media_page=2&member_media_limit=12 requests the second batch of 12 media items. Batch numbers and sizes must be integers from 1 through 100. Invalid values produce invalid_pagination and an empty result. Media, content pages, and playlists appear newest first. Playlist entries follow their stored order. Entry navigation parameters apply to all playlist entry collections in the same request. Generated links preserve validated collection navigation parameters, but do not preserve unrelated query parameters. You do not need a Liquid paginate block around these collections.

Member routes

These are navigation values, not a login-state signal. They remain available regardless of whether the visitor is signed in, so you can safely include both links in shared cached HTML.

Field	Value
`member_routes.root`	`/` on the current host: storefront home on the storefront, member home on the account host
`member_routes.sign_in`	Sign-in URL for the current surface, with a return destination
`member_routes.sign_out`	`/auth/sign_out` on the current host; use a normal link

Use member_routes.sign_in for sign-in links. Both hosts use /auth/sign_in; no theme login template or sign_in_url field is needed. There is no member_routes.csrf_token variable. See Sign in and sign out for complete examples and session behavior. settings.menu contains the current site’s navigation while preserving the theme’s other settings.

Field	Value
`settings.menu.title`	Menu title
`settings.menu.handle`	Menu slug, or empty for a derived menu
`settings.menu.menu_items`	Ordered items with `title`, `url`, and `sub_menu_items`

Render item URLs as provided. See the complete layout example in Member page templates.

Get Started

Core Concepts

Guides

Migration guides

Website & Themes

FairShare SDK

Files SDK

Portal & Widgets

Member Liquid variables

Where variables are available

Member profile

Lazy content collections

Collection fields

Media fields

Content page fields

Playlist fields

Playlist entry fields

Navigate collections

Member routes

Member site navigation

​Where variables are available

​Member profile

​Lazy content collections

​Collection fields

​Media fields

​Content page fields

​Playlist fields

​Playlist entry fields

​Navigate collections

​Member routes

​Member site navigation

Where variables are available

Member profile

Lazy content collections

Collection fields

Media fields

Content page fields

Playlist fields

Playlist entry fields

Navigate collections

Member routes

Member site navigation