How to Edit llms.txt and agents.md in a Shopify Theme

Shopify now lets theme templates customise llms.txt, llms-full.txt and agents.md. Learn what these files do, what to include and how to edit them safely.

Liquid Gold Updated 3 min read

On May 28, 2026, Shopify’s developer changelog noted that theme templates can customise /agents.md, /llms.txt and /llms-full.txt. These files give AI agents guidance about what to read on your site. This post explains what they are for and how to approach editing them without breaking anything.

What these files are

  • agents.md is the main agent-discovery document. Shopify treats /agents.md as the canonical file.
  • llms.txt is an alternate address for the same kind of guidance, a short, curated summary of your site and its most important pages.
  • llms-full.txt is a longer version with more detail.

Shopify generates default versions of these files for every store, so your store already has them even if you never touch a template.

They are emerging conventions, not guaranteed ranking factors. No major search engine has promised to use them as a ranking signal, so treat them as a low-cost way to help AI tools understand your store.

Which template controls what

According to Shopify’s theme documentation:

  • templates/agents.md.liquid controls /agents.md, /llms.txt and /llms-full.txt together. For sitewide changes, this is the one to edit.
  • templates/llms.txt.liquid overrides /llms.txt only.
  • templates/llms-full.txt.liquid overrides /llms-full.txt only.

If a path has no template of its own, Shopify falls back to your agents.md template, then to its own generated default. In most cases Shopify recommends not adding a separate llms.txt.liquid, so all three files stay consistent. Check the theme documentation for the Liquid objects available in these templates before you build.

What to put in them

Keep the content factual and concise.

For llms.txt:

  • A one or two sentence description of your brand and what you sell
  • Links to your main collections, key product categories and best sellers
  • Links to shipping, returns and contact pages
  • A link to your sitemap

For llms-full.txt:

  • Fuller descriptions of categories and policies
  • Sizing, materials or compatibility information
  • Frequently asked questions in plain language

For agents.md:

  • Notes on how to interpret your catalogue, such as how variants work
  • Anything an agent should know before recommending products, such as regional shipping limits

What not to include

  • Claims you cannot support
  • Private or customer data
  • Pricing that changes constantly unless it is generated dynamically
  • Keyword stuffing

Safe editing steps

  1. Duplicate your live theme.
  2. Make the change in the duplicate.
  3. Preview the file URL, such as yourstore.com/llms.txt, on the preview theme if possible.
  4. Check that it renders as plain text and the links work.
  5. Publish when you are satisfied.
  6. Review it quarterly, since catalogues and policies change.

Keep expectations realistic

These files help communicate with AI tools. They do not replace good product data, fast pages or honest reviews. If you are choosing between spending time on llms.txt or fixing your product descriptions, fix the descriptions first.

FAQ

Will llms.txt improve my Google rankings? There is no confirmed ranking benefit. Its value is helping AI tools find your key pages.

Can I edit these files without code? Shopify’s default files need no setup. To customise them, you add a Liquid template to your theme, so some code editing is needed. A developer can set it up.

Related reading: Shopify Magic, AI Collection Sorting on Shopify: Does It Beat Manual Merchandising? and 12 Shopify Flow Automations Every Store Should Set Up.

Need it set up?

Liquid Gold’s theme development service can add and maintain these files safely. Talk about theme development →

Keep reading

Related articles