BridgeToAgentGet the kit — $49
All install guides
Shopify~6 minBeginner

Install your Agentic Kit on Shopify

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.

Step 1 — Upload the three files to Shopify Files

  1. In Shopify admin, go to Content → Files.

  2. Click Upload files.

  3. Select all three files from the ZIP:

    • agents.json
    • llms.txt
    • agent-instructions.md

  4. Once uploaded, click each row to copy its CDN URL. They look like:

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

    Copy each of the three URLs into a notepad — you need them in step 2.

Step 2 — Create URL redirects

  1. Go to Online Store → Navigation.
  2. Click View URL redirects (top right).
  3. Click Create URL redirect and add these three redirects, one at a time:
Redirect fromRedirect to
/agents.jsonthe CDN URL you copied for agents.json
/llms.txtthe CDN URL you copied for llms.txt
/agent-instructions.mdthe 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>.

  1. Go to Online Store → Themes.
  2. Next to your live theme, click Actions → Edit code.
  3. Open layout/theme.liquid.
  4. 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">
  1. 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.

Need a hand? Reply to your purchase receipt and we'll help directly.