# Theme objects

> The objects a theme template can use, and their fields.

This page lists every Liquid object available in theme templates along with its fields. The list comes directly from the theme engine's source code: the fields shown here are the exact fields the engine exposes. Prices are whole numbers in kuruş; format them using the `money` filters.

## On every page

| Object | Description | Example |
| :--- | :--- | :--- |
| `shop` | The store. | `{{ shop.name }}` |
| `settings` | Global theme settings (`config/settings_data.json`). | `{{ settings.color_background }}` |
| `request` | Current HTTP request context. | `{{ request.locale.iso_code }}` |
| `routes` | Storefront route paths. | `{{ routes.cart_url }}` |
| `template` | The template currently being rendered. | `{{ template.name }}` |
| `theme` | Active theme metadata. | `{{ theme.name }}` |
| `localization` | Available countries and languages. | `{{ localization.language.iso_code }}` |
| `cart` | The visitor's shopping cart. | `{{ cart.item_count }}` |
| `customer` | The signed-in customer; empty when signed out. | `{% if customer %}{{ customer.first_name }}{% endif %}` |
| `collections` | Store collections; also accessible by handle. | `{{ collections.all.products_count }}` |
| `all_products` | Look up a product by handle (up to 20 products per page). | `{{ all_products['mug'].title }}` |
| `linklists` | Navigation menus, keyed by handle. | `{% for link in linklists['main-menu'].links %}` |
| `pages` | Content pages, keyed by handle. | `{{ pages['about-us'].content }}` |
| `blogs` | Blogs; also accessible by handle. | `{% for article in blogs['news'].articles limit: 3 %}` |
| `articles` | Blog posts, keyed by `blog/post` handle. | `{{ articles['news/first-post'].title }}` |
| `images` | Store image files, keyed by filename. | `{{ images['logo.png'] \| image_url: width: 200 }}` |
| `content_for_header` | Platform `<head>` scripts and styles; required in `theme.liquid`. | `{{ content_for_header }}` |
| `content_for_layout` | Rendered template output; required in `theme.liquid`. | `{{ content_for_layout }}` |
| `canonical_url` | Canonical URL of the current page. | `<link rel="canonical" href="{{ canonical_url }}">` |
| `page_title` | Page title for `<title>`. | `<title>{{ page_title }}</title>` |
| `page_description` | Meta description for the page. | `{{ page_description \| escape }}` |
| `page_image` | Social sharing image for the page. | `{{ page_image \| image_url: width: 1200 }}` |
| `current_page` | Current page number during pagination. | `{{ current_page }}` |
| `current_tags` | Active tag filters on a collection or blog page. | `{% if current_tags contains tag %}` |
| `handle` | Handle of the current page's primary resource. | `{{ handle }}` |
| `powered_by_link` | Platform attribution link. | `{{ powered_by_link }}` |
| `country_option_tags`, `all_country_option_tags` | `<option>` elements for country selectors. | `<select>{{ country_option_tags }}</select>` |
| `recommendations` | Product recommendations (populated inside `/recommendations/products`). | `{% if recommendations.performed %}` |
| `closest` | Resources nearest to the current page: `closest.product`, `closest.collection`, `closest.page`, `closest.blog`, `closest.article`. | `{{ closest.product.title }}` |

`scripts` is defined but empty, and `additional_checkout_buttons` is always `false`.

Each template also exposes its own primary object globally: `product` on product pages, `collection` on collection pages, `page` on content pages, `blog` on blog pages, `blog` and `article` on article pages, `search` on search pages, `gift_card` on gift card pages, and `predictive_search` in predictive search results.

## Sections and blocks

| Object | Fields |
| :--- | :--- |
| `section` | `id`, `settings`, `blocks`, `index`, `index0`, `location` |
| `block` | `id`, `type`, `settings`, `blocks`, `biticaret_attributes` |

```liquid
<h2>{{ section.settings.heading | escape }}</h2>
```

## Objects that tags provide

| Object | Where | Fields |
| :--- | :--- | :--- |
| `forloop` | Inside `{% for %}` | `name`, `length`, `parentloop`, `index`, `index0`, `rindex`, `rindex0`, `first`, `last` |
| `tablerowloop` | Inside `{% tablerow %}` | `length`, `col`, `col0`, `row`, `index`, `index0`, `rindex`, `rindex0`, `first`, `last`, `col_first`, `col_last` |
| `paginate` | Inside `{% paginate %}` | `current_page`, `current_offset`, `items`, `pages`, `page_size`, `page_param`, `parts`, `previous`, `next` |
| `form` | Inside `{% form %}` | `id`, `posted_successfully?`, `errors`, `set_as_default_checkbox`, `password_needed` and the form's own fields |

**Form errors** (`form.errors`): `messages`, `translated_fields`, `size`.

```liquid
{%- paginate collection.products by 24 -%}
  {%- if paginate.pages > 1 %}{{ paginate | default_pagination }}{% endif -%}
{%- endpaginate -%}
```

## Store

**`shop`**: `id`, `name`, `description`, `email`, `phone`, `domain`, `permanent_domain`, `url`, `secure_url`, `currency`, `money_format`, `money_with_currency_format`, `locale`, `taxes_included`, `address`, `password_message`, `customer_accounts_enabled`, `customer_accounts_optional`, `accepts_gift_cards`, `enabled_payment_types`, `enabled_currencies`, `published_locales`, `enabled_locales`, `policies`, `privacy_policy`, `refund_policy`, `shipping_policy`, `terms_of_service`, `subscription_policy`, `contact_information`, `legal_notice`, `products_count`, `collections_count`, `types`, `vendors`, `search_types`, `metafields`, `brand`.

**Policy** (`shop.privacy_policy` and the others): `id`, `title`, `body`, `url`, `handle`.

**`request`**: `design_mode`, `visual_preview_mode`, `host`, `origin`, `path`, `page_type`, `locale`.

**`routes`**: `root_url`, `account_url`, `account_login_url`, `account_logout_url`, `account_register_url`, `account_recover_url`, `account_addresses_url`, `account_profile_url`, `storefront_login_url`, `collections_url`, `all_products_collection_url`, `search_url`, `predictive_search_url`, `cart_url`, `cart_add_url`, `cart_change_url`, `cart_clear_url`, `cart_update_url`, `product_recommendations_url`.

```liquid
<a href="{{ routes.cart_url }}">{{ 'general.cart' | t }} ({{ cart.item_count }})</a>
```

**`template`**: `name`, `suffix`, `directory`.

**`theme`**: `id`, `name`, `role`.

**`localization`**: `available_countries`, `available_languages`, `country`, `language`, `market`.

**Country** (`localization.country`): `iso_code`, `name`, `continent`, `currency`, `unit_system`, `popular?`, `available_languages`, `market`.

**Market** (`localization.market`): `id`, `handle`, `name`, `metafields`.

## Products

**`product`**: `id`, `handle`, `title`, `type`, `vendor`, `description`, `content`, `tags`, `template_suffix`, `url`, `created_at`, `published_at`, `updated_at`, `price`, `price_min`, `price_max`, `price_varies`, `compare_at_price`, `compare_at_price_min`, `compare_at_price_max`, `compare_at_price_varies`, `available`, `variants`, `variants_count`, `has_only_default_variant`, `first_available_variant`, `selected_variant`, `selected_or_first_available_variant`, `options`, `options_with_values`, `options_by_name`, `featured_image`, `featured_media`, `images`, `media`, `collections`, `metafields`, `category`, `gift_card?`, `selling_plan_groups`, `selected_selling_plan`, `selected_selling_plan_allocation`, `selected_or_first_available_selling_plan_allocation`, `requires_selling_plan`, `quantity_price_breaks_configured?`.

A product can have at most 2,048 variants. `product.variants` and `product | json` return the first 250. `variants_count`, prices, option values and `?variant=` cover all variants, and `/products/<product>.js` lists every variant.

The subscription and volume-pricing fields on products, variants and cart lines (`selling_plan_…`, `requires_selling_plan`, `quantity_price_breaks…`) exist on the objects for theme compatibility, but always return empty values because the platform does not sell subscriptions.

```liquid
{%- assign current = product.selected_or_first_available_variant -%}
<h1>{{ product.title }}</h1>
<p>
  {{ current.price | money }}
  {%- if current.compare_at_price > current.price %} <s>{{ current.compare_at_price | money }}</s>{% endif %}
</p>
```

**Variant** (`product.variants`): `id`, `title`, `sku`, `barcode`, `available`, `selected`, `matched`, `url`, `price`, `compare_at_price`, `unit_price`, `unit_price_measurement`, `inventory_management`, `inventory_policy`, `inventory_quantity`, `image`, `featured_image`, `featured_media`, `options`, `options_with_values`, `option1`, `option2`, `option3`, `requires_shipping`, `taxable`, `weight`, `weight_unit`, `weight_in_unit`, `metafields`, `product`, `position`, `quantity_rule`, `store_availabilities`, `incoming`, `next_incoming_date`, `selected_selling_plan_allocation`, `selling_plan_allocations`, `requires_selling_plan`, `quantity_price_breaks`, `quantity_price_breaks_configured?`.

**Option** (`product.options_with_values`): `name`, `position`, `values`, `selected_value`.

**Option value**: `id`, `name`, `selected`, `available`, `variant`, `product_url`, `swatch`.

**Image** (`product.featured_image`, `product.images`): `id`, `alt`, `src`, `width`, `height`, `aspect_ratio`, `presentation`, `media_type`, `position`, `product_id`, `variants`, `attached_to_variant?`, `preview_image`, `url`.

**Focal point** (`image.presentation.focal_point`): `x`, `y`.

**Media** (`product.media`): `id`, `alt`, `media_type`, `position`, `preview_image`, `aspect_ratio`, `host`, `external_id`, `duration`, `sources`.

**Video URL** (a setting of type `video_url`): `id`, `type`.

## Collections

**`collection`**: `id`, `handle`, `title`, `description`, `url`, `published_at`, `updated_at`, `template_suffix`, `image`, `featured_image`, `metafields`, `products`, `products_count`, `all_products_count`, `all_tags`, `all_types`, `all_vendors`, `tags`, `current_type`, `current_vendor`, `default_sort_by`, `sort_by`, `sort_options`, `filters`, `next_product`, `previous_product`.

`next_product` and `previous_product` are populated on product pages accessed via `/collections/<collection>/products/<product>`.

**Filter** (`collection.filters`, `search.filters`): `label`, `param_name`, `type`, `operator`, `presentation`, `values`, `active_values`, `inactive_values`, `true_value`, `false_value`, `min_value`, `max_value`, `range_max`, `url_to_remove`.

**Filter value**: `active`, `value`, `label`, `count`, `param_name`, `image`, `swatch`, `url_to_add`, `url_to_remove`.

## Content and menus

**`page`**: `id`, `handle`, `title`, `content`, `author`, `url`, `published_at`, `created_at`, `updated_at`, `template_suffix`, `metafields`.

**`blog`**: `id`, `handle`, `title`, `url`, `articles`, `articles_count`, `all_tags`, `tags`, `comments_enabled?`, `moderated?`, `next_article`, `previous_article`, `template_suffix`, `metafields`.

`blog.articles` is sorted newest first and works with `paginate`. At `/blogs/<blog>/tagged/<tag>` it contains only posts matching that tag, and `blog.tags` holds the selected tags. `next_article` (older) and `previous_article` (newer) are populated on individual post pages.

**`article`**: `id`, `handle`, `title`, `author`, `content`, `excerpt`, `excerpt_or_content`, `image`, `tags`, `url`, `published_at`, `created_at`, `updated_at`, `template_suffix`, `user`, `comments`, `comments_count`, `comments_enabled?`, `moderated?`, `comment_post_url`, `metafields`.

Blog comments are not supported: `comments` is empty, `comments_count` is `0`, and `comments_enabled?` is `false`.

**Author** (`article.user`): `name`, `first_name`, `last_name`, `account_owner`, `bio`, `email`, `homepage`, `image`. The name fields are populated from the post's author field; the remaining fields are empty.

```liquid
{%- paginate blog.articles by 6 -%}
  {%- for article in blog.articles -%}
    <h2><a href="{{ article.url }}">{{ article.title }}</a></h2>
    {{ article.excerpt_or_content | strip_html | truncate: 160 }}
  {%- endfor -%}
  {{ paginate | default_pagination }}
{%- endpaginate -%}
```

**Menu** (`linklists['<handle>']`): `handle`, `title`, `id`, `links`, `levels`.

**Link** (`linklist.links`): `title`, `url`, `handle`, `links`, `levels`, `active`, `current`, `child_active`, `child_current`, `type`, `object`, `data_sharing_opt_out_icon`.

```liquid
{%- for link in section.settings.menu.links -%}
  <li><a href="{{ link.url }}"{% if link.current %} aria-current="page"{% endif %}>{{ link.title }}</a></li>
{%- endfor -%}
```

## Cart

**`cart`**: `items`, `item_count`, `empty?`, `items_subtotal_price`, `original_total_price`, `total_price`, `checkout_charge_amount`, `total_discount`, `discount_applications`, `cart_level_discount_applications`, `discounts`, `attributes`, `note`, `currency`, `requires_shipping`, `taxes_included`, `duties_included`, `total_weight`, `token`, `company_location`.

**Line item** (`cart.items`): `id`, `key`, `quantity`, `product`, `product_id`, `variant`, `variant_id`, `title`, `sku`, `vendor`, `url`, `url_to_remove`, `image`, `options_with_values`, `properties`, `original_price`, `price`, `original_line_price`, `line_price`, `final_price`, `final_line_price`, `line_level_total_discount`, `total_discount`, `discount_allocations`, `line_level_discount_allocations`, `discounts`, `tax_lines`, `message`, `unit_price`, `unit_price_measurement`, `error_message`, `components`, `gift_card`, `requires_shipping`, `taxable`, `grams`, `selling_plan_allocation`, `fulfillment`, `fulfillment_service`, `successfully_fulfilled_quantity`.

**Company location** (`cart.company_location`, when shopping for a company): `id`, `name`, `company_name`, `payment_terms`, `tax_exempt`.

## Customers

**`customer`**: `id`, `email`, `first_name`, `last_name`, `name`, `phone`, `accepts_marketing`, `accepts_sms_marketing`, `has_account`, `tax_exempt`, `b2b?`, `tags`, `orders_count`, `total_spent`, `default_address`, `addresses`, `addresses_count`, `orders`, `last_order`, `store_credit_account`, `gift_cards`, `metafields`.

**Customer order** (`customer.orders`): `id`, `name`, `order_number`, `created_at`, `cancelled`, `cancelled_at`, `financial_status`, `fulfillment_status`, `total_price`, `cash_total_price`, `installment_count`, `installment_markup`, `customer_url`, `shipping_method` (`title`, `delivery_method`), `delivery_method` (`shipping`, `pickup` or `local_delivery`), `pickup_location` (for store-pickup orders: `name`, `address`, `instructions`, `ready_in`), `payment_terms`, `attributes` (the order's cart attributes; for gift orders: `Hediye` for gift toggle, `Hediye notu` for gift note, and `Fiyatları gizle` for hide prices).

**Address** (`customer.default_address`, `shop.address`): `id`, `first_name`, `last_name`, `name`, `company`, `address1`, `address2`, `street`, `city`, `province`, `province_code`, `zip`, `country`, `country_code`, `phone`, `summary`.

## Search

**`search`**: `performed`, `terms`, `results`, `results_count`, `types`, `filters`, `sort_by`, `default_sort_by`, `sort_options`.

**`predictive_search`**: `performed`, `terms`, `types`, `resources` (`products`, `collections`, `pages`, `articles`, `queries`).

**`recommendations`**: `performed`, `performed?`, `products`, `products_count`, `intent`.

## Gift cards

**`gift_card`** (on the `/gift_cards/<token>` page): `balance`, `initial_value`, `currency`, `enabled`, `expired`, `expires_on`, `last_four_characters`, `code`, `url`, `qr_identifier`, `pass_url`, `customer`, `product`, `send_on`, `message`, `recipient`, `template_suffix`, `properties`, `created_at`.

**Gift card customer** (`gift_card.customer`): `name`.

**Store credit** (`customer.store_credit_account`): `balance`, `currency`.

## Metafields

The `metafields` property on `product`, variants, `collection`, `blog`, `article`, `customer` and `shop` is accessed by namespace and key. `page.metafields` is empty.

`value` returns the typed value: a number, boolean, date or string, or a parsed object for `json` and `rating` fields. For reference types (`product_reference`, `variant_reference`, `collection_reference`, `page_reference`, `blog_reference`, `article_reference`, `file_reference`, `metaobject_reference` and `list.*` variants), `value` resolves to the referenced object (or a list of objects); missing references are omitted. `file_reference` resolves to an image or video media object. `customer_reference` is always empty on the storefront so one customer's record is never exposed to anyone else.

**Metafield**: `value`, `type`, `namespace`, `key`, `list?`.

```liquid
{{ product.metafields.custom.care_guide.value }}
```

**`app`** (in app blocks): `metafields`, the app's own metafields.

## Metaobjects

The store's metaobject types (**Ayarlar > Özel veriler**, Settings > Custom data in the admin) are exposed via `metaobjects.<type>`: `metaobjects.<type>.<entry handle>` returns a single entry, and `metaobjects.<type>.values` returns the type's entries (up to 250). Only active entries are visible on the storefront; drafts are omitted.

**Metaobject entry** (`metaobject`): `system`.

**Entry system fields** (`metaobject.system`): `handle`, `type`, `id`, `url`.

Each field of an entry is exposed as a metafield under its key: `.value` returns the typed value, and outputting the field directly prints its value. `url` is populated only when the type has web pages enabled.

The `value` of a `metaobject_reference` metafield is the entry itself; for `list.metaobject_reference` it is a list of entries. Entries of a type with web pages enabled render at `/pages/<type handle>/<entry handle>` using `templates/metaobject/<type>.json` (or `.liquid`), where the entry is exposed as the `metaobject` object. Without that template, the route returns 404.

```liquid
{% for book in metaobjects.book.values %}{{ book.title.value }}{% endfor %}
{{ metaobjects.book.dune.author }}
{% for b in product.metafields.custom.books.value %}<a href="{{ b.system.url }}">{{ b.title }}</a>{% endfor %}
```

## Setting values

**Color** (a setting of type `color`): `red`, `green`, `blue`, `alpha`, `hue`, `saturation`, `lightness`, `chroma`, `color_space`, `rgb`, `rgba`, `oklch`, `oklcha`.

**Color scheme** (a setting of type `color_scheme`): `id`, `settings`.

**Font** (a setting of type `font_picker`): `family`, `fallback_families`, `style`, `weight`, `baseline_ratio`, `system?`, `system`, `variants`.
