The agent-readiness checklist for Shopify stores
AI shopping agents read stores differently from people. These are the 25 checks a Glass Aisle audit runs, in six dimensions worth 100 points. Each one links to what it measures, why agents care and how to fix it on Shopify.
Access: can agents reach your pages?
- A1Let AI agents read your store through robots.txt
Search engines and AI assistants read robots.txt before anything else on your site. A rule written for one crawler can keep out the ones that recommend your products to shoppers. Worth 6 points.
- A2Let honest crawlers past your bot protection
Bot protection is meant to stop scrapers and fraud. Set too tight, it also turns away the crawlers and assistants that announce exactly who they are. Worth 5 points.
- A3Keep pop-ups from hiding your products
Browser agents load your pages in a real browser, as a shopper does. If the first thing they see is a pop-up that covers the product, many of them never get past it. Worth 4 points.
- A4Put price and stock in your page's HTML
Many agents fetch your page and read the HTML as it arrives, without running any scripts. If your theme fills in the price or the stock status with JavaScript, those agents never see it. Worth 5 points.
Discovery: can agents find your products?
- D1Make sure your sitemap lists your products
Your sitemap is the list of pages you hand to search engines and agents. Shopify writes one for you, so most problems come from something that changed it or from links that no longer reach a product. Worth 4 points.
- D2Publish your store's agent profile (UCP)
The Universal Commerce Protocol, or UCP, is how AI agents learn what a store can do for them, such as search its catalog, build a cart or hand a shopper to checkout. A store announces this in a profile at /.well-known/ucp. Worth 5 points.
- D3Make sure agents can find your products by name
Agents that shop through UCP don't browse your pages first. They search your catalog and work from what comes back, so a product the search misses is invisible to them. Worth 3 points.
- D4Add an llms.txt file, and keep it short
llms.txt is a short Markdown file at the root of a site that points AI tools to its most useful pages. It's cheap to add, and few agents read it yet. Worth 1 point.
- D5Give each product one address agents can follow
A Shopify product can be reached at many addresses, such as through each collection it's in. The canonical tag tells agents which one is the real one, and links in your collection pages' HTML let them find products at all. Worth 2 points.
Product data: can agents understand what you sell?
- P1Give every product page complete structured data
Structured data is a block of JSON-LD in the page that states, in a form software reads without guessing, what the product is and what it costs. It's the most direct way to tell an agent the facts. Worth 6 points.
- P2Add the product details agents use to compare
Beyond the basics, a handful of fields let agents tell your product apart, match it to the same product elsewhere, and answer whether it's in stock. Worth 5 points.
- P3List every variant in your structured data
When a product comes in sizes or colors, an agent needs each option, its price and whether it's in stock. If your structured data describes only one variant, the rest are invisible. Worth 4 points.
- P4Make your structured data match the page
Structured data and the visible page should say the same thing. When they disagree, an agent may quote a price the shopper never sees. Worth 4 points.
- P5Answer shoppers' questions on your product pages
Shoppers ask agents specific questions: what it's made of, how it fits, whether it's dishwasher safe. An agent answers from your page's text, and when the answer isn't there it guesses or picks a store that has it. Worth 6 points.
Policies and trust: can agents answer pre-purchase questions?
- T1Put your return policy in structured data
Shoppers ask agents about returns before they buy. A MerchantReturnPolicy block states your terms in a form software reads exactly. Worth 4 points.
- T2Put shipping cost and delivery time in structured data
Shoppers ask an agent what delivery costs and how long it takes. OfferShippingDetails puts both answers in your structured data. Worth 4 points.
- T3Answer shipping and returns questions in plain words
Before they buy, shoppers ask an agent how long delivery takes and whether returns are free. The agent answers from your policy pages, so those pages need to state the answers plainly. Worth 4 points.
- T4Show agents who runs your store
Agents weigh whether a store is real and reachable before they send a shopper to it. Three plain signals answer that. Worth 3 points.
Checkout path: can an agent get a shopper to checkout?
- C1Tell agents whether they can check out on your store
Some AI channels can take a shopper through checkout without leaving the conversation. Your UCP profile tells them whether your store supports it. Worth 4 points.
- C2Make add to cart easy for browser agents
Browser agents use your store as a shopper does, by clicking. They find buttons and options by the names screen readers read, so an unlabeled or custom control can stop them. Worth 4 points.
- C3Keep cart links working
An agent that has found the right product can hand the shopper a link that opens checkout with it already in the cart. On Shopify that's a cart permalink, such as yourstore.com/cart/12345:1. Worth 4 points.
- C4Let shoppers check out without an account
When an agent hands a shopper to your checkout, a forced sign-in is one more step between them and the order. Worth 3 points.
Agent experience: how efficiently can agents read your pages?
- X2Keep product pages within what agents read
Agents read pages within a budget. A page with too much text or too much code gets cut, and the cut can fall before the details that matter. Worth 4 points.
- X3Give product pages a structure agents can follow
Agents rely on the same structure screen readers use: headings, landmarks and labels. A page built well for accessibility is easier for an agent to read. Worth 5 points.
- X4Offer agents a Markdown version of your pages
Some agents ask for a page as Markdown, plain text with light formatting, because it's much smaller than HTML. A site can answer that request with a Markdown version of the same page. Worth 1 point.
How the points add up to a score and a grade is on the methodology page.
Check your store against the list
The free audit reads your store the way an agent does and emails you your score, your grade and your top findings, with the evidence for each.