llms.txt.liquid

The llms.txt.liquid template renders the llms.txt file, which is hosted at the /llms.txt URL.

/llms.txt is an agent-discovery file and an alternate URL for /agents.md, which is the canonical agent-discovery document. By default, Shopify manages /llms.txt by mirroring the content of /agents.md, so agents and crawlers that request it still find a usable, agent-facing description of the store. For most stores, the managed file is all you need. As a result, this template isn't included in any themes by default.

Anchor to When to use this templateWhen to use this template

In most cases, don't add a separate llms.txt.liquid template. Shopify's managed default keeps /llms.txt aligned with /agents.md without extra theme maintenance. If you want to customize the agent-discovery content for every URL at once, then add an agents.md.liquid template instead. /llms.txt falls back to it automatically.

Add an llms.txt.liquid template only when you have an advanced requirement for /llms.txt to diverge from /agents.md. When you add this template, you hand-edit the Liquid template and take responsibility for keeping its content current. The template lookup order for /llms.txt is:

1. llms.txt.liquid (if present)
2. agents.md.liquid (if present)
3. The Shopify-generated default

So a dedicated llms.txt.liquid takes precedence for /llms.txt only, while /agents.md and /llms-full.txt are unaffected.

Anchor to LocationLocation

The llms.txt.liquid template is located in the templates directory of the theme:

If your theme doesn't already contain the llms.txt.liquid template, then you can add it with the following steps:

1. In the left sidebar, locate the Templates folder.
2. Right-click on the Templates folder.
3. Click New File from the context menu.
4. Name the file llms.txt.liquid.
5. Press Enter to create the file.

Anchor to ContentContent

This template can't be a JSON template. It must be llms.txt.liquid.

The template accepts standard text or Markdown and Liquid. Like agents.md.liquid, it has access to the agents object for auto-populated UCP and agent-interaction metadata. As with agents.md.liquid, this template renders with a restricted Liquid context: only the request object and the agents object are available, and the standard global Liquid objects such as shop, articles, and collections are not injected. For the full list of agents properties, refer to agents.md.liquid.

For example:

Anchor to UsageUsage

Use the Shopify-managed default unless you need custom content that differs from /agents.md. To customize the agent-discovery content for /agents.md, /llms.txt, and /llms-full.txt together, edit agents.md.liquid. Use llms.txt.liquid only when /llms.txt needs content that differs from /agents.md.