Themes
Theme tags
The Liquid tags a theme template can use, the form types, and whitespace control.
This page lists all tags registered in the theme engine, with an example of each. Any unknown tag fails biticaret theme check and theme upload.
If a tag fails at render time, it does not halt the entire page: Liquid error (sections/x.liquid line 3): … is output in its place and the rest of the page continues rendering.
Theme tags
| Tag | Description | Example |
|---|---|---|
section |
Renders a static section by name. | {% section 'header' %} |
sections |
Renders a section group. | {% sections 'header-group' %} |
content_for |
Renders theme blocks: 'blocks' renders all blocks; 'block' renders one specific block. |
{% content_for 'blocks' %} |
render |
Renders a snippet (snippets/) in an isolated scope; supports with, for and as. |
{% render 'product-card', product: product %} |
include |
Legacy form of render that shares the caller's scope. Use render in new code. |
{% include 'product-card' %} |
layout |
Selects the template's layout; none renders without a layout. |
{% layout 'password' %} |
form |
Renders a platform form with the appropriate action URL and hidden fields. | {% form 'product', product %}…{% endform %} |
paginate |
Paginates a list and provides the paginate object. |
{% paginate collection.products by 24 %}…{% endpaginate %} |
schema |
Declares a section's or block's settings schema (JSON); produces no output. | {% schema %}{ "name": "…" }{% endschema %} |
style |
Outputs a <style> element with Liquid evaluated inside it. |
{% style %}:root { --page-width: {{ settings.page_width }}px; }{% endstyle %} |
stylesheet |
Declares section CSS, compiled into the theme bundle with no inline output. | {% stylesheet %}.card { … }{% endstylesheet %} |
javascript |
Declares section JavaScript, compiled into the theme bundle with no inline output. | {% javascript %}…{% endjavascript %} |
Form types
| Type | Action path |
|---|---|
product |
/cart/add |
cart |
/cart |
contact, customer |
/contact |
localization |
/localization |
currency |
/cart/update |
storefront_password |
/password |
customer_login, guest_login |
/account/login |
create_customer |
/account |
recover_customer_password |
/account/recover |
reset_customer_password |
/account/reset |
activate_customer_password |
/account/activate |
customer_address |
/account/addresses |
new_comment |
/comments |
The create_customer, recover_customer_password, reset_customer_password, activate_customer_password and new_comment forms render markup, but the platform rejects submissions to those paths: customers sign in with a one-time email code rather than a password, and blog comments are not supported. The customer_login form reads only email (or customer[email]) and sends the sign-in code.
Forms that modify a customer account or send a message (contact, sign-in, address) include a hidden authenticity_token field for signed-in customers; guest submissions are validated against their referring page. Cart, product, currency and localization forms carry no token and are accepted only from the store's own pages.
{%- form 'product', product, class: 'form' -%}
<input type="hidden" name="id" value="{{ current.id }}">
<label>{{ 'products.product.quantity' | t }} <input type="number" name="quantity" value="1" min="1"></label>
<button class="button" type="submit">{{ 'products.product.add_to_cart' | t }}</button>
{%- endform -%}Variables
| Tag | Description | Example |
|---|---|---|
assign |
Defines a variable. | {% assign current = product.selected_or_first_available_variant %} |
capture |
Captures rendered output into a variable. | {% capture label %}{{ product.title }}{% endcapture %} |
increment |
Outputs a counter starting at 0, then increments it by 1. | {% increment counter %} |
decrement |
Decrements a counter by 1, then outputs it. | {% decrement counter %} |
echo |
Outputs an expression (like {{ … }}) inside {% liquid %}. |
{% echo product.title %} |
liquid |
Evaluates multiple tags one per line without delimiters. | Below |
{%- liquid
assign featured = section.settings.collection
if featured == blank
assign featured = collections.all
endif
-%}Conditions
| Tag | Description | Example |
|---|---|---|
if, elsif, else |
Renders when the condition is truthy. | {% if product.available %}…{% else %}…{% endif %} |
unless |
Renders when the condition is falsy. | {% unless variant.available %} disabled{% endunless %} |
case, when, else |
Branches on a value. | {% case template.name %}{% when 'product' %}…{% endcase %} |
ifchanged |
Renders only when its output differs from the previous iteration. | {% ifchanged %}{{ product.vendor }}{% endifchanged %} |
Loops
| Tag | Description | Example |
|---|---|---|
for, else |
Loops over a collection (else runs when empty). Accepts limit, offset and reversed. |
{% for product in featured.products limit: 8 %}…{% endfor %} |
break |
Exits the enclosing loop. | {% break %} |
continue |
Skips to the next iteration. | {% continue %} |
cycle |
Outputs the next value in sequence on each iteration. | {% cycle 'odd', 'even' %} |
tablerow |
Outputs items as HTML table rows and cells; accepts cols. |
{% tablerow product in collection.products cols: 3 %}…{% endtablerow %} |
Comments and raw text
| Tag | Description | Example |
|---|---|---|
comment |
Ignores its body and produces no output. | {% comment %}…{% endcomment %} |
# |
Single-line comment inside a tag. | {% # note %} |
doc |
Snippet documentation block; produces no output. | {% doc %}…{% enddoc %} |
raw |
Outputs its contents literally without evaluating Liquid. | {% raw %}{{ as is }}{% endraw %} |
Whitespace control
Adding hyphens ({%-, -%}, {{-, -}}) strips whitespace on the corresponding side of the tag:
{%- if product.featured_media -%}
<div class="product__media">{{ product.featured_media | image_url: width: 800 | image_tag: loading: 'lazy' }}</div>
{%- endif -%}