Structured data is markup embedded in your storefront’s pages that describes your products, reviews, and store information in a format search engines and AI tools can read directly — rather than having to guess at it from visible page text. Google and other search engines use it to show rich results (star ratings, price, availability) directly in search listings, and AI assistants use it the same way they’d use llms.txt — as a structured, reliable source of facts about your store.

X-Cart generates this markup automatically, using the JSON-LD format (the format Google recommends), based on data you’ve already entered in your store — there’s nothing to write yourself.

This feature is provided by the “Site Structured Data” add-on (formerly known as "Rich google search results").

What’s included

Once the “Site Structured Data” add-on is enabled, X-Cart automatically adds structured data to:

Product pages — describes the product itself (name, description, image, SKU)
and its price and availability (currency, in stock or not), using the schema.org
types Product and Offer. Depending on what’s set up for the product, it also includes:
- Ratings and reviews — if the Product reviews add-on is enabled and the product has reviews, its average rating and up to 5 individual reviews are included.
- Brand — if the product is assigned a brand (Shop By Brand).
- Product identifiers — MPN, GTIN, and ISBN. If the Barcode and Manufacturer Part Number fields add-on is enabled, these come from its fields (Manufacturer Part # for MPN; UPC or EAN for GTIN; ISBN for ISBN). Otherwise, X-Cart falls back to your store’s custom product attributes (Catalog → Classes & attributes) — if you have one named exactly “MPN”, “GTIN”, or “ISBN”, its value is used.
- Vehicle fitment (stores using the Make/Model/Year fitment feature) — up to 5 compatible vehicles. If a product has more than 5, the first 5 are included along with a link to its full compatibility list.
- Variations — if the Product Variations add-on is enabled and the product has variations, X-Cart adds a shared ProductGroup block describing the product line as a whole, and links each variation's page back to it, so search engines understand they're the same product line.
- Color, size, material, and pattern — from product attributes with matching names, or from your Google Product Feed field mappings if that add-on is enabled and configured.
- Audience and condition — if the Google Product Feed add-on is enabled, its Gender and Age group mappings are included as audience information, and its Condition mapping sets the item’s condition (defaults to New if not mapped).
- Any other custom attributes — product attributes (Catalog → Classes & attributes) not already covered above.

Category and other pages with breadcrumbs — a breadcrumb trail (BreadcrumbList) that mirrors your storefront’s category hierarchy.

Structured data is cached for up to 12 hours, so changes you make to a product can take up to that long to appear in its markup — or clear your store’s cache to see them immediately.

Enabling and configuring Site Structured Data

Site Structured Data is an add-on, enabled by default on most store distributions. If you need to check or change its status:

In your admin, go to Apps → My Apps.
Find Site Structured Data in your list of installed add-ons.
Enable, disable, or open its settings from there.

Site Structured Data add-on (enabled)

Beyond enabling the add-on itself, the only additional settings available are for Corporate contact markup, described below — the rest of the structured data described above requires no configuration and reflects your existing store and product data automatically.

Corporate contact markup

Corporate contact markup adds structured data describing your business (an Organization block, in the same invisible JSON-LD markup described above) to your storefront’s home page only — it doesn’t appear on other pages, and it isn’t visible anywhere in your storefront or admin; like the rest of this markup, you’d only see it by viewing the page’s source code (see “Checking your structured data” below). It includes your store name, URL, logo, phone, fax, and postal address (from Store → Store Profile, the “Company Address” section), plus a contact point search engines can use to reach your business directly from search results. It’s off by default.

To enable Corporate contact markup, open the Site Structured Data add-on’s settings and configure:

Corporate contact settings

Enable Corporate Contact markup — the toggle that turns this section on. Off by default.
Contact type — for example, Customer service, Technical support, Sales, or Billing support. Defaults to Customer service.
Served countries and Available language — the countries and languages this contact option covers.
Contact options — additional details such as Toll-free or Hearing impaired supported.
Override phone number — by default, this markup uses the Phone field from Store → Store Profile (“Company Address” section). Fill in this field only if you need a different number for this markup specifically. The number must be in international format, starting with “+” followed by the country code.

Note: Once Corporate contact markup is enabled, your support email — the HelpDesk/Support service field, under Store → Store Profile → “Contact Emails” — is included in this markup automatically too, even though it isn’t listed above. It isn’t optional and there’s no separate toggle for it.

Checking your structured data

To confirm your structured data is working as expected on a specific page:

Open the page on your live storefront.
Use Google’s Rich Results Test or the Schema.org Validator — paste in your page’s URL.
Review the results. A product page should show Product and BreadcrumbList as eligible for rich results, with no errors (warnings for optional fields are normal).

You can also see the raw markup yourself: open your browser’s developer tools on a product page (right-click → Inspect → Elements/Sources) and search for application/ld+json. On an automotive store with fitment data, it looks something like this (trimmed):

{   
  "@context": "https://schema.org/",
  "@type": "Product",
  "name": "Example Wheel — Silver with Machined Face",
  "sku": "52596051",
  "brand": { "@type": "Brand", "name": "Example Brand" },
  "additionalProperty": [
    { "@type": "PropertyValue", "name": "Diameter [inch]", "value": "18" }
  ],   
  "offers": {
    "@type": "Offer",
    "priceCurrency": "USD",
    "price": 340,
    "availability": "https://schema.org/InStock"
  },
  "isAccessoryOrSparePartFor": [
    { "@type": "Car", "brand": { "@type": "Brand", "name": "ALFA ROMEO" }, "model":
"Giulia", "vehicleModelDate": "2020" }
  ],
  "subjectOf": { "@type": "WebPage", "name": "Full Compatibility List", "url":
"https://yourstore.com/product/example-wheel#product-details-tab-specification" }
}

FAQ

Q: Do I need to do anything for this to start working?

A: No, if your store distribution has Site Structured Data enabled by default. It uses your existing product, review, brand, and category data automatically — there’s nothing separate to fill in, aside from the optional Corporate contact section.

Q: Why don’t I see my recent product changes reflected in the structured data?

A: Structured data for a page is cached for up to 12 hours, so a change can take that long to appear on its own. To see it immediately, clear your store’s cache from the admin area.

Q: Why does a product’s structured data only show 5 reviews or 5 vehicle fitments, when it has more?

A: This is a fixed limit in the current version. Reviews show your product’s 5 most recent approved reviews; fitments show the first 5 compatible vehicles, with a link to the full compatibility list for the rest.

Q: Can I customize what’s included in the structured data?

A: Not beyond the Corporate contact section — the rest is generated automatically and isn’t user-configurable in this version.

Q: Is “Site Structured Data” the same as the “Rich Google Search Results” add-on?

A: Yes — it’s the same add-on, renamed and rewritten (from microdata to JSON-LD, plus new support for product variations and vehicle fitments) as of X-Cart 5.6.0.13. If you’re on an earlier version and see “Rich Google Search Results” instead, that’s the same add-on under its previous name. If you upgrade across this version, the change happens automatically — your add-on’s enabled status and settings carry over as-is, and there’s no separate notification about the rename; this article is that notice.

Q: Is the "Site Structured Data" add-on by CFL Systems the same thing?

A: No. That's a separate, third-party add-on, unrelated to this one, which was

discontinued in January 2026. The add-on covered in this article is X-Cart's own

built-in add-on (formerly "Rich Google Search Results") — it isn't from CFL

Systems and doesn't require purchasing anything from the marketplace.

Q: Does this replace or conflict with llms.txt?

A: No. They’re complementary and can both be enabled — structured data is aimed at traditional search engines (via schema.org/JSON-LD), while llms.txt is a separate file aimed specifically at AI assistants and generative-engine crawlers. See Using llms.txt for Generative Engine Optimization (GEO).

Can't find answers you're looking for?

Email us at support@x-cart.com. We will be happy to help!

Related articles