What is agents.md, and what did Shopify put in yours?
Last reviewed
Short answer
agents.md is a file Shopify now serves at /agents.md on every Shopify-rendered storefront. Shopify's dev docs call it the canonical, agent-facing description of a store: it tells AI agents how to browse the catalog, where the commerce endpoints live, and what the store's policies are. It shipped in early May 2026, and since 28 May you can override it with a theme template.
What is actually in the file
We read the default file on live stores on 29 August 2026 rather than describing it from coverage. It is a short Markdown document, around 4KB, with the same sections on every store we checked.
It opens by pointing personal shopping assistants at the Shop app's skill file, then documents the store's Universal Commerce Protocol endpoints and a six-step flow an agent can follow from search to completed checkout. It lists read-only JSON endpoints for products, collections and search. It states rules for agents, including that payment must not be completed without explicit buyer consent. It ends with links to the store's policy pages.
- A pointer to the Shop app skill for personal shopping assistants
- UCP discovery and MCP endpoints, with supported protocol versions
- Read-only endpoints: /products/{handle}.json, /collections/{handle}/products.json, /search
- Agent rules, including explicit buyer consent before payment
- Links to privacy, terms and refund policies
How it got here, which was not graceful
The file appeared on storefronts in the first week of May 2026 with no changelog entry. Merchants noticed because their existing custom llms.txt files stopped being served: Shopify's generated files overrode custom versions delivered through theme templates and app proxies, and for a stretch in late May /llms.txt was redirected outright to /agents.md.
The formal fix landed on 28 May 2026, when Shopify published theme templates for all three files. Today /llms.txt is no longer a redirect: it returns its own copy that mirrors agents.md, with a line noting that /agents.md is the canonical version. The episode is worth remembering for what it says about the platform: agent-facing surfaces ship first and get documented after.
Can you customise it?
Yes, since 28 May 2026. Add a template called agents.md.liquid in your theme's code editor and Shopify renders yours instead of the default. Separate templates exist for llms.txt.liquid and llms-full.txt.liquid, and each falls back to agents.md.liquid, then to Shopify's generated default.
The template runs in a restricted Liquid context: Shopify's docs state only the request and agents objects are available. It is served at your bare primary domain and there are no localised variants. Whether you should spend time here is the next section.
Does anything actually read it?
Honest answer: no AI vendor has confirmed consuming agents.md, and Shopify's own documentation describes what the file offers agents rather than naming who reads it. The syndication that puts your products in front of ChatGPT and Copilot runs through Shopify Catalog, not through this file.
The nearby evidence is also cautionary. When we looked at llms.txt, Ahrefs' study of 137,210 domains found 97% of published files got zero requests. agents.md is newer, carries live commerce endpoints, and Shopify points an agentic discovery sitemap at it, so its odds are better. But if you are choosing where an afternoon goes, product data that Catalog demonstrably syndicates beats a file with no confirmed readers.
The headless caveat
These files are served by Shopify's storefront rendering layer. A fully headless store on custom infrastructure returns 404 on all of them, including the UCP endpoints, and the theme-template customisation route does not apply. We verified this on a live headless store.
If you are headless and want an agent-facing surface, it is yours to build and serve. The community thread on the rollout raised exactly this and it remains the state of things as of our review date.
Frequently asked questions
Is agents.md the same as llms.txt?
On Shopify, today, effectively yes. /llms.txt serves a mirror of agents.md with a note that /agents.md is the canonical version. They are different proposals historically: llms.txt was a community idea for LLM-readable site summaries, agents.md is Shopify's agent-facing store description.
Do I need an app to generate agents.md or llms.txt?
No. Shopify serves all three files automatically on Shopify-rendered storefronts, and customisation is a free theme template. An app whose product is generating these files is selling something you already have.
Does ChatGPT read agents.md?
No vendor has confirmed reading it. Your products reach ChatGPT through Shopify Catalog syndication, which does not depend on this file. Treat agents.md as infrastructure Shopify maintains for future agents rather than a lever that moves visibility today.
My custom llms.txt disappeared in May. What happened?
Shopify's generated files overrode custom llms.txt files served through themes and app proxies when the rollout landed in early May 2026, without advance notice. Since 28 May you can restore your version with an llms.txt.liquid theme template, which takes precedence over the default.
Sources
- Shopify Dev: the agents.md.liquid template
- Shopify changelog: customise llms.txt, llms-full.txt and agents.md (28 May 2026)
- Shopify dev community: llms.txt and agents.md thread (May 2026)
- Shopify Help: Shopify agentic storefronts
- Craftshift: the native llms.txt and agentic discovery rollout, early coverage
Keep reading
Score your own catalog
Entitled grades every product against the rules on this page, explains each failure, and fixes them with AI you approve. The score is free forever.