How to Customize Your Shopify agents.md in Two Minutes

Shopify generates an agents.md for every store and serves it at yourstore.com/agents.md. The trouble is the default reads almost identically to every other store and points shopping agents at Shopify's own rails on shop.app instead of telling them what makes you worth picking. We covered why that matters in the agents.md pillar and why an identical file makes you interchangeable to agents.

This is the how-to. Two steps, about two minutes.

Why you paste a file instead of clicking install

Worth understanding before you start, because it explains the one paste. Shopify serves /agents.md natively from the root of your domain. An app can't redirect that path, and it can't serve the file through an app proxy. The only supported way to override the generated file is a theme template at templates/agents.md.liquid.

So a customization has to live in your theme. An app could in principle write that file for you, but doing so needs a special theme-write grant Shopify gates carefully, and handing an app blanket access to edit your theme is a permission most merchants would rather not give. The clean alternative is to have the file generated from your live store and paste it in yourself. You stay in control of your theme, and the file is plain Markdown you own outright, not app code.

Step 1: Generate your file in AgentReady

Open AgentReady and go to Settings > Agent instructions (agents.md). It builds a complete, brand-specific agents.md from your live catalog, collections, policies, FAQs, reviews and best-sellers, with the UCP and MCP transaction rails matched to Shopify's. A quality score shows what's covered and what would make the file stronger, so you can fill gaps before you publish.

Click Copy file to put the whole thing on your clipboard.

Step 2: Paste it into your theme (once)

In your Shopify admin, go to Online Store > Themes > Edit code. Under Templates, create the file agents.md.liquid (create it directly under the templates folder with that exact name; the "Add a new template" picker can save it under the wrong name). Paste the generated content in, and Save.

That's the customization done. Back in AgentReady, mark it pasted so the app can track when your store later drifts from what's live.

Keeping it current

Your agents.md is a snapshot of your store at the moment you pasted it. When your catalog, policies, or collections change, AgentReady detects the drift and flags you with what changed, then hands you the updated file to copy and paste over the old one. New flagship products, a revised return policy, a seasonal collection: the app tells you it's time, you paste, you're current again. If nothing's changed, there's nothing to do.

Verify it

Open https://yourstore.com/agents.md in a browser. You should see your brand content, not the generic default. Because a single template overrides all three paths, the same file now serves /llms.txt and /llms-full.txt too, so check one and you've confirmed all three. (Shopify caches the file, so give it a minute after pasting.)

If you'd rather see the state of your file before you start, the free AI-readiness checker fetches your store the way an agent does and reports whether your agents.md is Distinctive, Generic-default, or Missing.

It's your file, in your theme

There's no app code in your theme and no hidden dependency. What you pasted is plain Markdown that you own: it serves exactly as written, it travels with the theme you pasted it into, and AgentReady reading or writing nothing into your theme means there's nothing to break if you stop using it. To go back to Shopify's generated default, delete the templates/agents.md.liquid file. That's the entire cleanup.

The trade is honest: because the file lives in your theme rather than being written for you, you re-paste it when your store changes. That's why AgentReady does the watching, generating, and flagging, so the only manual step is a copy and a save. (Wondering how agents.md relates to robots.txt and llms.txt? See what each file does.)

Run the checker to see which state your file is in, then open AgentReady and generate yours in two minutes.