Fix the catalog
Every Shopify store now serves an agents.md. Here is what to do with it.
By Ankit Minocha. Founder, Atomz. Updated June 17, 2026.
The Spring 2026 Edition quietly standardized something the rest of the web has been improvising. Every Shopify store now automatically serves a set of agent-discovery files that an AI agent can read to learn how the store works. There are three, and Shopify names a canonical one.
| File | Role |
|---|---|
/agents.md | The canonical agent-discovery URL, the source of truth |
/llms.txt | Compatible with older AI crawlers, same information |
/llms-full.txt | The fuller version for crawlers that look for it |
By default these carry your store name, URL, sitemap link, store policies, and discovery endpoints. You can override them with theme templates: agents.md.liquid controls all three, while llms.txt.liquid and llms-full.txt.liquid override their specific files, with the URL-specific template taking precedence.
Why the default is not enough
The default file is a business card that tells an agent your name and your policies, but it does not tell an agent what you are best at, which categories define you, what makes your range distinctive, or how your catalog is organized for a buyer. For a store with a point of view, leaving the default in place is leaving the introduction to a template.
This is the open-web companion to Shopify Catalog. The catalog is the structured, syndicated layer an agent queries directly, while the agents.md file is the readable manifesto an agent consults to understand the store behind those products. Both now exist on every store, but only one of them is filled in for you.
The robots.txt detail that changes the rules
Shopify is explicit about something that catches people out. Blocking AI crawlers at robots.txt or the CDN affects only open-web discoverability. It does not stop your product data from being sent by Shopify Catalog to the agentic storefronts you have activated. In other words, robots.txt no longer governs whether AI can see your products. Shopify Catalog is the visibility layer for the syndicated channels, and it runs on its own controls in the Agentic section of admin, not on your robots file.
What this means
The old playbook was: manage robots.txt to control AI access. The new reality is two separate layers. Robots.txt still governs open-web crawlers, but your syndicated product visibility is controlled by Shopify Catalog access settings, and your store's introduction to agents is controlled by agents.md. Both deserve to be written, not defaulted.
What to put in agents.md
Treat it as the briefing you would give a knowledgeable assistant who is about to recommend your store. State plainly what you sell and who you are for, name the categories that define you, point to your best collections, and surface the policies and facts an agent needs to recommend you with confidence. Keep it specific and current, because a stale or generic file does the introduction badly.
Writing and maintaining the agents.md file, alongside the catalog work underneath it, is exactly the kind of thing the audit at gpt.atomz.ai checks. It is the new robots.txt for the agent era, and almost no one has written theirs yet.
Subscribe to The Agentic Operator