Seoxpert.io
Get started
mediumTechnical SEO

JSON-LD Schema Missing Required Fields for Rich Results

Some JSON-LD schema blocks are missing required fields for Google rich-result eligibility, preventing enhanced SERP features.

By Seoxpert Editorial · Published

Why it matters

Missing required fields in JSON-LD schema prevents Google from displaying rich results like star ratings, prices, or breadcrumbs. This reduces your site's visibility and click-through rates in search results, as users don't see enhanced snippets. Proper schema implementation is essential to benefit from these SERP features.

Impact

Pages with incomplete schema are ineligible for rich results, losing potential visibility and engagement in search results.

How it's detected

An automated SEO crawler parses JSON-LD blocks and checks for the presence of required fields per schema type against Google's documentation.

Common causes

  • Omitting required fields such as datePublished for Article or price for Product
  • Copy-pasting example schema without customizing required fields
  • Misunderstanding which fields are mandatory for each schema type
  • Failing to update schema when page content changes
  • Using outdated schema specifications

How to fix it

Identify which required fields are missing for each schema type (e.g., Article needs datePublished in ISO 8601). Add these fields to your JSON-LD blocks. For example, ensure Product includes offers.price, offers.priceCurrency, and offers.availability. Validate your pages with Google's Rich Results Test to confirm eligibility before deployment.

Code examples

Incorrect Article schema (missing datePublished)

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Use SEO Tools"
}

Corrected Article schema (with datePublished)

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "How to Use SEO Tools",
  "datePublished": "2023-12-01T10:00:00Z"
}

FAQ

What fields are required for Article schema to be eligible for rich results?

At minimum, Article schema needs 'headline' and 'datePublished' (in ISO 8601 format) for rich result eligibility.

How do I know which fields are required for my schema type?

Refer to Google's documentation for each schema type or use the Rich Results Test to identify missing required fields.

Will missing optional fields prevent rich results?

No, only missing required fields will prevent eligibility; optional fields may enhance the snippet but are not mandatory.

How can I test if my schema is eligible for rich results?

Use Google's Rich Results Test at search.google.com/test/rich-results to validate your schema implementation.

Found this issue on your site?

Run a scan to see if JSON-LD Schema Missing Required Fields for Rich Results affects your pages.

Scan my website →