Liquid reference

Themes are Liquid templates rendered in ShopFast's sandboxed engine. This page is generated from the engine itself: 107 filters, 26 tags and 9 object types. If it is here, it works in a theme.

How rendering works

• Output is HTML-escaped by default. Rich text (description_html) is sanitized before it reaches a theme.
• Strict filters: an unknown filter is an error when you publish. Snippets render with {% render %} and see only what you pass them.
• Every section renders on a time, memory and template budget; a broken section becomes a placeholder, never a broken page.
• Money is integer minor units: {{ product.price | money }} prints $24.99 for 2499.

Global objects

• title

ShopFast filters

• artShopFast

  A decorative SVG from the theme art set.

  {{ 'grid' | art }}
• asset_urlShopFast

  URL of a theme image from config/assets.json.

  {{ 'hero.png' | asset_url }}
• coverShopFast

  The generated SVG cover for a product (folded planes from its id and type).

  {{ product | cover: 'wide' }}
• editableShopFast

  Marks text the visual editor can edit in place.

  {{ section.settings.heading | editable: 'heading' }}
• faq_jsonldShopFast

  FAQPage JSON-LD from question blocks.

  {{ section.blocks | faq_jsonld }}
• handleShopFast

  Alias of handleize.

  {{ title | handle }}
• handleizeShopFast

  Lowercase, dash-separated handle: golden-hour.

  {{ "Golden Hour" | handleize }}
• hmac_sha256ShopFast

  Hex HMAC-SHA256.

  {{ text | hmac_sha256: 'key' }}
• image_tagShopFast

  A full <img> with width, height and alt.

  {{ section.settings.image | image_tag: loading: 'lazy' }}
• image_urlShopFast

  URL of an image setting or theme image, resized.

  {{ section.settings.image | image_url: width: 800 }}
• iso_dateShopFast

  An ISO 8601 date string for <time datetime>.

  {{ article.created_at | iso_date }}
• jsonShopFast

  JSON for data attributes, escaped for HTML.

  {{ product | json }}
• jsonldShopFast

  A safe <script type="application/ld+json"> block.

  {{ data | jsonld }}
• moneyShopFast

  Minor units to the store currency: 2499 → $24.99.

  {{ product.price | money }}
• money_with_currencyShopFast

  Like money, followed by the ISO code: $24.99 USD.

  {{ product.price | money_with_currency }}
• money_without_currencyShopFast

  The amount without a symbol: 24.99.

  {{ product.price | money_without_currency }}
• pluralizeShopFast

  Picks the singular when the number is 1.

  {{ n | pluralize: 'item', 'items' }}
• sha256ShopFast

  Hex SHA-256 of a string.

  {{ text | sha256 }}
• starsShopFast

  Accessible star rating markup.

  {{ product.rating.value | stars }}
• tShopFast

  A string from the theme locale file, with variables: {{ 'cart.items' | t: count: 3 }}.

  {{ 'cart.title' | t }}
• type_labelShopFast

  Human label for a product type: license_key → License key.

  {{ product.type | type_label }}
• videoShopFast

  Parses a YouTube or Vimeo URL into an embeddable player.

  {{ section.settings.video_url | video }}

Standard filters

LiquidJS filters, all available: abs, append, array_to_sentence_string, at_least, at_most, base64_decode, base64_encode, capitalize, ceil, cgi_escape, compact, concat, date, date_to_long_string, date_to_rfc822, date_to_string, date_to_xmlschema, default, divided_by, downcase, escape, escape_once, find, find_exp, find_index, find_index_exp, first, floor, group_by, group_by_exp, has, has_exp, inspect, join, jsonify, last, lstrip, map, minus, modulo, newline_to_br, normalize_whitespace, number_of_words, plus, pop, prepend, push, raw, reject, reject_exp, remove, remove_first, remove_last, replace, replace_first, replace_last, reverse, round, rstrip, sample, shift, size, slice, slugify, sort, sort_natural, split, squish, strip, strip_html, strip_newlines, sum, times, to_integer, truncate, truncatewords, uniq, unshift, upcase, uri_escape, url_decode, url_encode, where, where_exp, xml_escape.

Tags

• {% assign %}Standard

  Standard Liquid tag.

• {% block %}Disabled

  Not available: use {% content_for %} and theme blocks.

• {% break %}Standard

  Standard Liquid tag.

• {% capture %}Standard

  Standard Liquid tag.

• {% case %}Standard

  Standard Liquid tag.

• {% comment %}Standard

  Standard Liquid tag.

• {% content_for %}ShopFast

  Renders blocks: {% content_for 'blocks' %} or a single theme block.

• {% continue %}Standard

  Standard Liquid tag.

• {% cycle %}Standard

  Standard Liquid tag.

• {% decrement %}Standard

  Standard Liquid tag.

• {% echo %}ShopFast

  Outputs an expression inside {% liquid %}.

• {% for %}Standard

  Standard Liquid tag.

• {% if %}Standard

  Standard Liquid tag.

• {% include %}Disabled

  Not available: use {% render %}, which keeps snippet variables isolated.

• {% increment %}Standard

  Standard Liquid tag.

• {% javascript %}Disabled

  Not available: themes ship no JavaScript; interactive blocks use the ShopFast storefront runtime.

• {% layout %}Disabled

  Not available: templates choose their layout in their JSON file.

• {% liquid %}ShopFast

  Several tags in one block, one per line.

• {% raw %}Standard

  Standard Liquid tag.

• {% render %}ShopFast

  Renders a snippet with its own variables: {% render 'product-card', product: product %}.

• {% schema %}ShopFast

  The section's settings, blocks and presets as JSON. Read by the editor, never rendered.

• {% sections %}ShopFast

  Renders a section group (header-group, footer-group, overlay-group).

• {% style %}ShopFast

  Scoped <style> for a section, with settings available as CSS variables.

• {% stylesheet %}ShopFast

  CSS for a section or the library, compiled into the theme stylesheet (never inline).

• {% tablerow %}Standard

  Standard Liquid tag.

• {% unless %}Standard

  Standard Liquid tag.

Objects

Review

Promotion

PromotionBanner (extends Promotion)

Media

Product

FeatureGroup

Variant

Collection

Page