AgentReadyAI visibility appCaffeine & CommerceShopify agency
Caffeine and Commerce
Caffeine and Commerce
By Dylan HuntJune 14th, 2026aishopifyagents-md

Your Shopify agents.md Is Identical to Every Other Store (And It's Sending AI Shoppers to Shop, Not You)

Your Shopify agents.md Is Identical to Every Other Store (And It's Sending AI Shoppers to Shop, Not You)

Open your store's yourstore.com/agents.md in a browser. Then open a competitor's. If you have never customized the file, the two read almost the same, because Shopify wrote both of them from the same template. That sameness is the problem, and almost no merchant has noticed it yet.

The default exists, and that's the trap

Since Spring 2026, Shopify generates an agents.md for every store and serves it at the domain root. It is the canonical AI-discovery file now, with /llms.txt and /llms-full.txt mirroring it. The file is always present. It is always valid. A naive check that asks "do you have an agents.md?" returns a green check for everyone.

But the default content is generic. It says the kind of thing any store could say, and it routes shopping agents to install https://shop.app/SKILL.md, Shopify's own agentic rails. That is a sensible default for the platform. It is a weak one for you. The file that is supposed to be your pitch to the machine reads like boilerplate, and it hands the agent off to Shopify's rails rather than to a reason to pick you.

We call this state Generic-default, as opposed to Distinctive (customized to your brand) or Missing (no file at all). Generic-default is the most common state and the most dangerous, because it looks like success. The light is green. Nothing is broken. You are simply saying nothing.

Identical is invisible

Here is why sameness is fatal in this channel specifically. An AI shopping assistant is not browsing your store the way a person does. It is reading machine-readable signals and deciding, fast, whether you fit a shopper's question and whether to surface you over the next store. When your file is identical to everyone else's, you have handed it zero grounds to choose you. You have made yourself a commodity at the exact moment a commodity gets dropped from the shortlist.

This is the same failure we documented from a different angle in why AI shopping shows your brand but skips your category. Brands reliably show up when a shopper asks for them by name, because the store is the authoritative source for its own products. They vanish on the category queries, the "good daily trainer for marathon training" searches, that bring new customers. A generic agents.md is one more way you win your own name and lose the category. It tells the assistant nothing about which categories you should win.

And it compounds with the buy box. When several stores sell the same product, Shopify's Global Catalog clusters them and picks one offer to show. If your file gives the assistant no distinctive reason to favor you, you fall back to competing on price, shipping, and ratings alone, the signals you have the least control over in the moment. A distinctive file is one of the few levers you actually hold.

The fix is one file

You override the default by creating a templates/agents.md.liquid template in your theme. It is a Liquid and Markdown file, and that single template replaces /agents.md, /llms.txt, and /llms-full.txt at once. Keep the UCP and MCP rails the default gives you, because an agent needs them to transact, then add the sections the default omits:

  • What we sell, in your own words, naming the categories you want to be found for.
  • Why buy from us: the materials, the proof, the promise that lowers a buyer's risk.
  • Featured products and your real policies, pulled from your live catalog.

Use Shopify's agents Liquid object (agents.store_name, agents.mcp_endpoint_url, agents.ucp_discovery_url, and the rest) so the transactional endpoints stay in sync with the platform. One caution: do not inline a contact email or phone number, since the file is broadly cached. The full walkthrough, with a copy-pasteable template, is in agents.md on Shopify: what it is and how to customize yours.

Check yours in ten seconds

The free AI-readiness checker reads your store the way an agent would and tells you whether your agents.md is Distinctive, Generic-default, or Missing. If you have never touched the file, expect Generic-default, the same boilerplate every other store is serving.

If it comes back generic, AgentReady is building a generator that turns your live catalog into a brand-specific agents.md.liquid and keeps it current, so the file works for you instead of for the template. Start by seeing where you stand.

Run the checker and find out if your store reads like everyone else's.

Make your store agent-ready

Get found and recommended by AI shopping assistants.

AgentReady adds Schema.org structured data, an llms.txt directory, and an AI-readability audit to your Shopify store, so ChatGPT, Perplexity, and Google can understand and recommend your products. Free for stores under 500 products.

Comments

Every comment here comes from a verified email. Write yours, confirm from your inbox, and it's live.

Loading comments…

Leave a comment

ShareXLinkedInFacebook

Written by Dylan Hunt, Founder, Caffeine and Commerce. We build Shopify stores that rank and that AI agents can read. Have a project? Get in touch.