Install your Agentic Kit on Shopify

Heads-up (May 13, 2026): On May 12 Shopify announced Agentic Storefronts — automatic structured product data piped to AI shopping channels (effective May 25, 2026 for qualifying merchants). That covers product discovery. It does not cover your blog, FAQ, support pages, policies, About page, or any non-product content an agent reads when answering questions that aren't "place an order now." The kit handles the rest. Full breakdown →.

Shopify does not let you upload arbitrary files at the root path of your domain. The cleanest workaround is to upload via the Files area, then create URL Redirects from /agents.json, /llms.txt, and /agent-instructions.md to the CDN URLs Shopify gives back.

You'll be done in under 10 minutes.

⚠️ Use Content → Files. Not Content → Pages. Pages render as HTML, which corrupts the JSON in agents.json and breaks AI agent parsing. The install must go through Files + URL Redirects so the original file content-type is preserved.

Step 1 — Upload the three files to Shopify Files

In Shopify admin, open the left sidebar and click Content to expand it.
Click Files (not Pages — see warning above).
Click Upload files in the top right.
Select all three files from the ZIP:
- agents.json
- llms.txt
- agent-instructions.md
Once uploaded, click each row to reveal its CDN URL. Click the copy icon next to each URL. They look like:

https://cdn.shopify.com/s/files/1/0123/4567/files/agents.json?v=1700000000

Save all three URLs in a notepad — you need them in Step 2.

Step 2 — Create URL redirects

Go to Online Store → Navigation.
Click View URL redirects (top right).
Click Create URL redirect and add these three redirects, one at a time:

Redirect from	Redirect to
`/agents.json`	the CDN URL you copied for `agents.json`
`/llms.txt`	the CDN URL you copied for `llms.txt`
`/agent-instructions.md`	the CDN URL you copied for `agent-instructions.md`

Save each one.

Step 3 — Verify

Open each URL in a new tab:

https://your-store.com/agents.json
https://your-store.com/llms.txt
https://your-store.com/agent-instructions.md

Each should serve the file content (Shopify performs a 301 redirect to the CDN URL behind the scenes — agents follow redirects fine).

Step 4 (recommended) — Add the auto-discovery snippet

Tell AI bots where to find these files directly from your <head>.

Go to Online Store → Themes.
Next to your live theme, click Actions → Edit code.
Open layout/theme.liquid.
Find the closing </head> tag and paste this immediately before it:

<link rel="alternate" type="application/json" title="Agent Action Map" href="/agents.json">
<link rel="alternate" type="text/plain" title="LLM Context" href="/llms.txt">
<link rel="alternate" type="text/markdown" title="Agent Runbook" href="/agent-instructions.md">

Click Save.

Alternative: a Cloudflare proxy (advanced)

If you front your Shopify domain with Cloudflare, you can serve the three files directly from a Cloudflare Worker or R2 bucket — no Shopify redirects needed. This gives true root-served files. We recommend this only if you already use Cloudflare for routing.

Troubleshooting

Redirect creates a loop. Make sure the destination URL is the full https://cdn.shopify.com/... URL — not a relative path.

File downloads instead of displaying in the browser. Shopify CDN serves them with Content-Disposition: attachment. This is fine for AI agents — they read the bytes either way. To force inline display you'd need a small proxy (see the Cloudflare alternative above).

?v=... cache buster makes the URL ugly. Ignore it. Agents follow the redirect and reach the file regardless of the query string.