Rich Snippets
Inject JSON-LD structured data into your BigCommerce storefront so Google can understand products, the organization, and merchant policies.
Overview#
Rich Snippets are JSON-LD blocks in the page HTML. Search engines read them to decide whether to show price, availability, reviews, shipping, and other extras — not just a blue link. AI Overviews and shopping surfaces also consume this markup.
AIReady injects scripts through BigCommerce Script Manager. Scripts are named AIReady - … JSON-LD. On Stencil product pages, product JSON-LD only renders when the page is a product with a URL, so an empty product object on the homepage does not leak Product schema.
Note: Rich results are never guaranteed. Google decides what to show. If you also configure policies in Google Merchant Center, Merchant Center settings take precedence for Shopping surfaces.
Why it is important#
- Product pages become eligible for price, stock, brand, and review rich results
- Organization + logo help Google identify the store as a real OnlineStore
- Shipping and return policies are required for many Merchant listings and free-shipping annotations
- Blog posts get BlogPosting dates and images so article rich results can fire
Theme HTML is not a substitute. Google’s documented path is JSON-LD on the page the shopper and the crawler actually load.
Surfaces#
- Homepage — WebPage, Organization, WebSite, optional SearchAction on the storefront home
- Product — Product, Offer, Brand, optional AggregateRating on product detail pages only
- Category — CollectionPage on category listings
- Brand — CollectionPage with a Brand entity
- Blog — BlogPosting on individual posts (dateModified and thumbnail when present)
- Merchant — ShippingService, MerchantReturnPolicy, MemberProgram on Organization; product Offers reference the return policy
The header pill shows how many of these surfaces are live (for example “2 of 6 live”).
Settings#
Homepage / site graph
- Enable site graph — master switch for homepage JSON-LD
- Include Organization — store name, URL, logo (on by default)
- Include WebSite — WebSite node pointing at the storefront (on by default)
- Include SearchAction — sitelinks search box markup; Google may ignore it (on by default)
- Category / brand / blog graphs — controlled from those tabs once site schema is published
Product
- Enable product schema — Product + Offer on every product detail page
- Price tax mode — price without tax (default) or with tax. VAT is declared on priceSpecification
- Default brand — fallback when the product has no brand
- Include SKU / brand — on by default
- Include GTIN/UPC + MPN — off by default; uses GTIN, else UPC, plus MPN when present
- Specify out-of-stock — Offer availability reflects inventory (on by default)
When data exists, product JSON-LD also includes images (always — falls back to the main image), description, category, aggregate rating from reviews, strikethrough (compare-at) price, and loyalty points on the Offer when a loyalty program is configured.
Publish schema#
- Open Rich Snippet.
- Choose a tab, set options, click Save settings (draft).
- Click Publish / Update for that surface.
- View Source on the storefront and look for the JSON-LD script tags.
Unpublish removes that surface. Remove all clears every AIReady Rich Snippet script, including leftover scripts from older “SEO Spider / SEO Optimizer” names so you do not get duplicate JSON-LD.
Category, brand, and blog graphs ride with the site (homepage) publish. Turn the matching include toggle off if you do not want that page type marked up.
Merchant policies#
The Merchant tab adds shipping, returns, and loyalty under Organization. Enabling Shipping or Returns opens the matching settings form — you cannot publish an empty policy. Product Offers reference the return policy. Shipping is declared on the organization.
Shipping
- Name / description / policy URL — service name is required before publish
- Countries / currency — ISO-2 codes and the currency for rates
- Free shipping — checkbox. If a minimum order is set, schema emits two bands: paid below the threshold, $0 at or above it
- Rate / min order / transit days — per condition
- Handling days — omitted from schema if both min and max are 0
Returns
- Mode — Detailed (full policy) or Link (URL only; URL required)
- Countries / policy country — where returns apply / which country’s law
- Return window — finite (days), unlimited, or not permitted
- Return method — by mail, in store, or kiosk
- Return fees — free, customer responsibility, or ReturnShippingFees (amount and currency required if you choose fees)
- Refund type — full refund, exchange, or store credit
- Item condition — new, used, damaged, refurbished
Loyalty
Optional MemberProgram: name, description, URL, and tiers (name, benefits, membership points earned). When a tier has points greater than 0, product Offers include those points. Save merchant settings, then Publish. That republishes site schema, and product schema if it is already live.