For Hydrogen & headless stores
Is your Hydrogen store agent-ready?
Generic readiness scanners assume a classic Liquid storefront. Headless Hydrogen builds split robots, sitemaps, structured data, and protocol endpoints across your own app — so the things Shopify serves for free are suddenly yours to wire up. Agent Ready checks the headless reality.
Scan your store →Why headless changes the answer
On a hosted Shopify theme, the platform emits a usable robots.txt, a sitemap, product JSON-LD, and (increasingly) agentic-commerce protocol surfaces for you. Go headless with Hydrogen and you own the request path: your Remix/React app decides what robots see, whether structured data is rendered on the server, and whether protocol endpoints exist at all. The most common failure isn't a misconfiguration — it's an absence. An agent that doesn't execute JavaScript sees an empty shell where your product data should be.
The Hydrogen agent-readiness checklist
Fifteen checks across five categories. The ones most often missed on headless builds are called out below.
Discoverability
- robots.txt is served by your Hydrogen app, not Shopify's online store — headless splits these, and most stores ship the framework default.
- sitemap.xml routes resolve on your custom domain, not the myshopify.com origin.
- AI bot user-agents (GPTBot, ClaudeBot, PerplexityBot, Google-Extended) have explicit rules.
Content
- llms.txt manifest at the domain root — the single highest-leverage file, and almost never present on a headless build.
- Markdown content negotiation (Accept: text/markdown) for product and policy pages.
Commerce protocols
- UCP profile exposed at /.well-known/ucp — Shopify ships this on Liquid storefronts, but headless apps must wire it through themselves.
- MCP server card discovery (SEP-2127).
- ACP / x402 / WebMCP opt-in markers where applicable.
Product data
- Product JSON-LD rendered server-side — client-only React hydration means agents that don't run JS see nothing.
- ProductGroup + variant/pricing clarity for variant families.
- Open Graph / Twitter cards on PDPs.
Checkout
- Cart permalinks resolve.
- Checkout handoff URL is reachable and not gated behind JS.
Built on Hydrogen? Don't guess — measure.
Agent Ready is open source and built by Weaverse, the team behind Hydrogen theme tooling. Scan once, subscribe, and we'll re-check weekly and email you when a deploy changes your score.
Run a free scan →