Turning on AI Discovery
AI Discovery is off by default. This page covers turning it on, setting up the surfaces you want, and confirming everything is actually reachable by AI agents.
Turn on the master switch
Section titled “Turn on the master switch”- Go to Settings and find the AI Discovery row, or open the AI channels page directly from the app navigation.
- Turn on the switch. On the AI channels page, this is the toggle next to AI Discovery on / AI Discovery off in the page header; on Settings, it’s the toggle on the AI Discovery row itself.
Turning it on starts publishing your catalog to AI agents: it makes your AI-facing metafields live, regenerates your discovery files, and (if you’d previously enabled it) reinstalls the agents.md router. Turning it off stops publishing (your discovery files and product metafields are left in place, just no longer served).
No external account or authorization is required, unlike Meta, TikTok, Pinterest, or Klaviyo, AI Discovery only touches your own store and theme.
Choose your surfaces
Section titled “Choose your surfaces”Once the master switch is on, turn on the individual surfaces you want from the AI channels page:
- Discovery files:
llms-full.txt,feed.json,sitemap-ai.xmleach have their own toggle. - Native agents.md: replaces Shopify’s generic router with one that points to your discovery files.
- Product JSON-LD: also requires enabling the AI Discovery (Máximo) theme app embed:
- In Shopify admin, go to Online Store → Themes → Customize.
- Open App embeds.
- Enable AI Discovery (Máximo).
- IndexNow: pushes catalog URL changes to Bing as they happen.
You can also add a Brand & policies summary (shipping, returns, sizing) that appears in llms-full.txt, and use Sync now under Shopify Catalog mapping to publish your AI-accepted product copy to Shopify metafields.
Confirm it’s working
Section titled “Confirm it’s working”The AI readiness card at the top of the AI channels page runs a live health check and tells you exactly what to fix:
| Check | What it confirms |
|---|---|
| AI Discovery | The master switch is on. |
| robots.txt & AI crawlers | Your storefront’s robots.txt doesn’t block AI Discovery crawlers from your product pages. |
| Product JSON-LD | The JSON-LD toggle is on and the AI Discovery embed is active on your live theme. |
| Native agents.md | Your router file is installed and verified on your live theme. |
| Discovery files freshness | Your enabled discovery files have regenerated within the last 48 hours. |
| Catalog metafield mapping | At least one product has AI copy published as metafields. |
Each row that needs attention includes a one-click fix, turn on a toggle, open the theme editor, or regenerate now.
Beyond the readiness check, the AI crawler activity and AI traffic & revenue cards on the same page fill in automatically once AI assistants start fetching your files or sending you shoppers, there’s nothing further to configure.
Next steps
Section titled “Next steps”- What you get: details on each surface listed above.
- Overview: why AI Discovery matters.