Skip to main content

Agent instructions variables

The LLMs Template (see Settings) is rendered with Liquid. This page is the full reference of the variables available in that template — what each one outputs and the fields on each item. They are served at /llms.txt and /agents.md.

Overview

VariableTypeDescription
{{ agentic.info }}textA ready-made protocol block describing the store's agent endpoints and how to connect.
{{ store.name }}textThe store name.
{{ store.url }}textThe store base URL.
{{ categories.all }}listAll catalogue categories (below the root).
{{ categories.level_N }}listCategories at a specific depth, e.g. {{ categories.level_2 }}.
{{ cms_pages }}listActive CMS pages for the store.
{{ policies }}listThe CMS pages chosen in the Policy Pages setting.
{{ products.featured }}listProducts flagged for agents via the Include in Agent Instructions attribute — see Featured products below.

Scalars

  • {{ agentic.info }} — a multi-line block (already formatted) that lists the store's agent endpoints and how an agent should connect. Drop it into the template as-is.
  • {{ store.name }}, {{ store.url }} — plain strings.

Categories

{{ categories.all }} returns every category below the store root. {{ categories.level_N }} returns only the categories at depth N (for example, categories.level_2 for top-level categories). Each item has:

FieldDescription
nameCategory name
urlFull category URL
product_countNumber of products in the category
## Categories
{% for category in categories.all %}
- [{{ category.name }}]({{ category.url }}) ({{ category.product_count }} products)
{% endfor %}

CMS pages and policies

Both {{ cms_pages }} and {{ policies }} are lists whose items have:

FieldDescription
titlePage title
urlFull page URL

{{ cms_pages }} lists active CMS pages; {{ policies }} lists only the pages selected in the Policy Pages setting (leave that setting empty to omit the section).

## Store Policies
{% for page in policies %}
- [{{ page.title }}]({{ page.url }})
{% endfor %}

{{ products.featured }} lists the products you flagged for agents by setting the Include in Agent Instructions attribute to Yes on the product. The list is capped at 50 products. Each item has:

FieldDescription
nameProduct name
urlFull product URL
skuProduct SKU
priceSelling price as an integer in minor units (for example, 2999 for $29.99)
currencyISO 4217 currency code, e.g. USD
## Featured products
{% for product in products.featured %}
- {{ product.name }} ({{ product.sku }}) — {{ product.url }}
{% endfor %}
note

price is in minor units to avoid rounding errors — divide by 100 for a 2-decimal currency.

note

{{ products.* }} is backed by a pluggable selection strategy. The strategy shipped with the extension returns the attribute-flagged products for any label, so {{ products.featured }} is the variable to use. Other labels (such as products.selected) return the same flagged set unless a developer registers a custom strategy.