AgentReady

Getting started with AgentReady Reviews

Turn on storefront display, add the three theme-editor blocks, and see what renders on first paint without JavaScript.

Last updated 2026-09-01

AgentReady Reviews shows approved reviews on your storefront and keeps them readable by AI agents. Storefront display, import, moderation, and export are free. This page is the first hour: turn the blocks on, confirm first paint, then import.

For the positioning, read Reviews AI agents can actually read. The sell page is AgentReady Reviews.

1. Install the app

Install AgentReady from the Shopify App Store. Reviews lives in the same app as structured data. There is no extra install for the review library.

2. Turn on storefront display

In AgentReady, open Reviews. The workspace is where you import, moderate, and reply. Storefront display does not inject itself. You add blocks in the theme editor. Nothing is injected into theme.liquid.

3. Add the three blocks

The shipped blocks are Product review stars, Product review list, and All store reviews. You add them in Online Store, Themes, Customize.

Deep links use the shipping theme-extension uid bbda2702-cc0b-f39b-f242-00dc64cddf585703e6c8 and the block handles product-stars, product-reviews, and site-reviews:

/admin/themes/current/editor?template=product&addAppBlockId=bbda2702-cc0b-f39b-f242-00dc64cddf585703e6c8/product-stars&target=mainSection
/admin/themes/current/editor?template=product&addAppBlockId=bbda2702-cc0b-f39b-f242-00dc64cddf585703e6c8/product-reviews&target=mainSection
/admin/themes/current/editor?template=page&addAppBlockId=bbda2702-cc0b-f39b-f242-00dc64cddf585703e6c8/site-reviews&target=mainSection

Save the theme after each add. The all-store block also works on the index template.

4. What renders on first paint

The stars and the first page of the list render from a Shopify metafield snapshot in Liquid. No AgentReady, Vercel, or database request is required for that first paint. A fetcher that reads the HTML sees the approved reviews.

Show more reviews, if later pages exist, loads through a signed endpoint on the store's own domain. That request is continuation only. Without JavaScript, the initial reviews stay on the page. Shoppers can sort and filter once the loader runs; with JavaScript off the first page stays newest-first. See sort and filter.

The product list can show a Write a review link to a form on your domain. New reviews arrive unverified and pending. See the write a review form.

See storefront blocks for every setting and default, and AI readability for what an agent sees in HTML, JSON-LD, and llms.txt.

5. Import your history

If you already have reviews in Judge.me, Okendo, Loox, or a CSV, import before you uninstall the old app. Start with Import from Judge.me, Okendo, Loox, or a CSV. Then walk the migration checklist.

What AI agents see

On a product with approved reviews, the first HTML response includes the star average and review bodies. AggregateRating JSON-LD is a separate switch: it emits only after a clear ownership check. Ratings also flow into agents.md and llms.txt on paid plans.