Shopify Squad About

Shopify Squad / Selling through AI chats

Shopify llms.txt and agents.md: how to edit them

What every Shopify store already serves at /agents.md and /llms.txt, and how to change it with a Liquid template.

3 min read

Your Shopify store already has an llms.txt file. Every store serves three files for AI agents, /agents.md, /llms.txt and /llms-full.txt, and by default all three return the same content. You don’t need an app to create them. To change what they say, you add a Liquid template to your theme.

Before you do, look at what’s there. Keep the managed default unless you need custom agent instructions: once you add a template, you maintain the file yourself.

See what your store serves now

Open these three addresses in a browser, using your store’s primary domain:

  • https://yourstore.com/agents.md
  • https://yourstore.com/llms.txt
  • https://yourstore.com/llms-full.txt

The default lists your store name, store URL, sitemap link, store policies, UCP discovery and MCP endpoints, read-only browsing URLs for products, collections and search, and guidance for personal shopping agents.

Shopify calls /agents.md the canonical agent discovery URL. /llms.txt and /llms-full.txt exist for older AI crawlers that look for those specific file names.

Choose which template to add

You want to changeAdd this templateURLs it changes
All three files at onceagents.md.liquid/agents.md, /llms.txt, /llms-full.txt
Only /llms.txtllms.txt.liquid/llms.txt
Only /llms-full.txtllms-full.txt.liquid/llms-full.txt

A URL-specific template wins for its own URL. For /llms.txt, Shopify checks llms.txt.liquid first, then agents.md.liquid, then its own default. So if you only want a shorter /llms.txt and leave /agents.md alone, add llms.txt.liquid and nothing else.

Create the template

  1. In your Shopify admin, go to Online Store.
  2. Next to the theme you’re editing, click the horizontal menu icon and select Edit code.
  3. Click Add a new template and select agents.md, llms.txt or llms-full.txt, depending on the URL you want to change.
  4. Click Create template.
  5. Make your edits, then click Save.

The file lands in the theme’s templates folder. These must be Liquid templates, not JSON. After saving, reload the URL in your browser to check the output.

Write the content

The template accepts Markdown and Liquid, but it renders in a restricted context. Only two objects are available: request and agents. Global objects such as shop, collections and pages render blank, so you can’t loop over your products or pull in page content.

Useful agents properties:

  • agents.store_name and agents.store_url
  • agents.sitemap_url
  • agents.ucp_discovery_url and agents.mcp_endpoint_url
  • agents.ucp_versions
  • agents.currency

A short llms.txt.liquid could look like this:

# {{ agents.store_name }}

> One or two sentences on what you sell and who it's for.
> The full agent instructions are at {{ agents.store_url }}/agents.md.

- UCP discovery: {{ agents.ucp_discovery_url }}
- MCP endpoint: {{ agents.mcp_endpoint_url }}
- Sitemap: {{ agents.sitemap_url }}

Rules:

  1. Use the agents object for UCP and MCP URLs. Don’t type them in by hand, so they stay correct when your store’s setup changes.
  2. Leave out private data. Don’t output contact email addresses or phone numbers.
  3. Write one version. The files are served only at your bare primary domain, with no locale or Shopify Markets prefix, and have no localized counterpart.
  4. Keep it up to date yourself. Shopify’s default stays aligned with its agent features. Your template doesn’t.

Because Shopify falls back to its default when no template exists, removing your template brings the managed file back.

What these files don’t do

If you’re editing these files because you want to sell through AI chats, the setup itself is covered in how to sell on ChatGPT with Shopify.

Sources