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.


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#

  1. Open Rich Snippet.
  2. Choose a tab, set options, click Save settings (draft).
  3. Click Publish / Update for that surface.
  4. 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.