Crystallize logo

What Is Structured Data? JSON-LD, Schema.org, and Ecommerce SEO

Structured data is a standardized way of describing website content so search engines and other software can understand its meaning.

In e-commerce, it identifies products, prices, availability, reviews, brands, and other relevant information. Structured data typically uses Schema.org vocabulary and JSON-LD syntax to support richer search results and machine-readable product discovery.

Search engines can read your product descriptions, but that doesn't mean they automatically understand every detail about what you're selling.

Is €199 the current price or an old promotional price? Does "midnight" describe a product color? Is a product rating attached to one variant or the entire product family?

Structured data helps remove some of that ambiguity.

How Does Structured Data Work?

Structured data describes information using standardized properties and relationships. For example, an e-commerce product page contains information such as a product name, description, brand, price, currency, and availability.

Humans understand these details through the page's design and content.

Machines benefit when that information is represented explicitly.

Three commonly supported formats for implementing structured data are JSON-LD, Microdata, and RDFa.

Google recommends JSON-LD because it keeps structured data separate from the visible HTML markup and is relatively straightforward to generate and maintain.

However, JSON-LD and Schema.org aren't the same thing. JSON-LD is a format for representing linked data using JSON. Schema.org provides the vocabulary for describing entities and their properties.

Together, they make website information easier for search engines and other systems to understand.

What Is Schema.org?

Schema.org is a collaborative project providing a shared vocabulary for describing structured information on the web.

Its vocabulary covers different types of entities, including:

  • Product for individual products.
  • ProductGroup for product families and variants.
  • Offer for purchasing information such as price and availability.
  • Organization for companies and other organizations.
  • BreadcrumbList for navigational hierarchies.
  • Article for editorial content.

Each type supports properties describing the entity. For example, a Product can have a name, description, image, brand, SKU, and associated offers.

Using these standardized properties helps search engines understand what the content represents.

Ecommerce Structured Data Example

A basic e-commerce product page might include the following JSON-LD markup:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Product",
  "name": "Alto Dining Chair",
  "description": "Solid oak dining chair in black.",
  "image": [
    "https://example.com/images/alto-chair.jpg"
  ],
  "sku": "ALTO-BLK",
  "brand": {
    "@type": "Brand",
    "name": "Northwind"
  },
  "offers": {
    "@type": "Offer",
    "url": "https://example.com/products/alto-chair",
    "priceCurrency": "EUR",
    "price": "349.00",
    "availability": "https://schema.org/InStock",
    "itemCondition": "https://schema.org/NewCondition"
  }
}
</script>

This example describes a product and its associated purchasing information. It gives search engines explicit values for properties that might otherwise need to be inferred from the visible page. In production, the URLs, price, availability, and other values must reflect the actual product being sold.

For products with multiple variants, Google's ProductGroup documentation provides a more suitable model.

How Does Structured Data Help Ecommerce SEO?

Structured data helps Google understand page content and can make eligible pages appear with enhanced search features.

For ecommerce, these may include product information such as prices, availability, ratings, and shipping details. However, adding structured data does not automatically improve organic rankings or guarantee rich results. Google evaluates eligibility according to its technical requirements, content guidelines, and search systems.

The practical benefit is clearer information representation and eligibility for relevant search appearances.

Structured Data for Google Merchant Listings

Google supports structured data specifically for merchant listings. These experiences can include product information across Google Search, Google Images, and other shopping-related search surfaces.

Merchant listing markup builds on Product and Offer properties.

Depending on the implementation, businesses can describe:

  • Product identity, name, and images.
  • Price and currency.
  • Availability and item condition.
  • Shipping information.
  • Return policies.
  • Product variants and identifiers.

Merchant listing eligibility has requirements distinct from general product snippets. In particular, merchant listings are intended for pages where customers can purchase the product.

Google also recommends including product markup in the initial HTML because rapidly changing product information may not always be reliably processed when markup depends on JavaScript rendering.

See Google's merchant listing structured data documentation for the current implementation requirements.

Structured Data for AI Search and Product Discovery

Structured data is becoming relevant beyond traditional search results. AI-powered systems increasingly help customers discover, compare, and evaluate products. These experiences depend on access to reliable product information.

Structured data can make product facts explicit on publicly accessible web pages. However, an important distinction is often overlooked.

Structured data helps describe products, but it doesn't automatically make a catalog accessible to every AI assistant or guarantee citations in AI-generated answers.

Google states that no special AI-specific structured data is required for AI Overviews or AI Mode. Similarly, other AI shopping systems may use different sources, including product feeds, search indexes, APIs, and merchant integrations.

That means structured data should be one representation of your catalog, not a separate source of product truth.

Our guide to machine-readable product data explains how Schema.org, product feeds, GraphQL, semantic search, and MCP solve different machine-access problems.

The most sustainable architecture generates these representations from the same underlying product model.

Structured Data in Headless Ecommerce

In a headless architecture, product information is managed independently of the frontend. This creates an opportunity to generate structured data directly from the commerce backend.

For example, a headless PIM can maintain product attributes, variants, media, prices, and relationships in structured fields. The storefront can then use those values to generate JSON-LD alongside the visible product page. This reduces duplicated data entry and helps prevent inconsistencies between what customers see and what search engines read.

But it also introduces implementation responsibility.

Developers must ensure that structured data updates when product information changes and that rendered markup accurately reflects the selected product or variant.

Structured Data Testing Tools

How Do You Test Structured Data?

Before deploying structured data, validate both its syntax and its eligibility for search features.

Useful tools include:

Validation should also include business correctness. A technically valid product schema containing an outdated price is still wrong.

Structured data is most valuable when it reflects a reliable product model, stays synchronized with the storefront, and gives machines accurate information without forcing them to guess.