Fix guide

Schema markup errors and warnings: how to fix them

About 3 min read Time to do it: 20 min Updated
Quick answerFix syntax errors first, then required and recommended properties, and confirm the markup matches visible content.
On this page
  1. Is this your problem?
  2. Why this matters for SEO
  3. Common causes
  4. Step-by-step fix
  5. How to confirm it worked
  6. Mistakes to avoid
  7. Tools to use
  8. FAQ
  9. Related guides

Why this matters for SEO

Fix syntax errors first, then required and recommended properties, and confirm the markup matches visible content.

Search visibility depends on several systems agreeing: the page must be reachable, discoverable, technically eligible to be indexed, useful for the query, and supported by a clear internal site structure. Fixing one symptom while another system is blocking the page can produce little or no improvement.

Use this guide as a focused workflow rather than a checklist to complete blindly. Confirm the actual page and response first, make the smallest defensible change, then re-test the same evidence after deployment.

Is this your problem?

  • Validation reports invalid JSON or missing fields.
  • Search Console shows structured data errors.

Common causes

  • Stray commas, quotes or unescaped characters.
  • Required properties for the type are missing.
  • Markup describes content not on the page.
Diagnosis order

Check access and HTTP status first, then robots and indexability directives, canonicalization, content/template quality, internal links and performance. This order prevents a low-priority content edit from hiding a technical blocker.

Step-by-step fix

  1. Validate

    Paste your JSON-LD into the Schema Markup Validator.

  2. Fix syntax

    Correct commas, brackets and quotes so it parses.

  3. Add missing fields

    Provide the required and recommended properties for the chosen type.

  4. Match visible content

    Remove or correct any property that is not shown on the page.

  5. Re-test

    Validate again and check the live URL.

How to confirm it worked

The validator reports no syntax errors and the properties reflect the visible page.

Verification should use the same URL and comparable conditions as the original test. Check the HTTP response, rendered/source markup and the relevant Google Search Console report where applicable. A successful technical change does not guarantee immediate indexing; crawling and indexing can take time and Google may still choose not to index a page it considers redundant or low quality.

Mistakes to avoid

  • Copying markup from another site unchanged.
  • Adding review or rating markup that does not exist.

Tools to use

Schema Markup Validator
Schema Markup Generator

FAQ

Do warnings matter?

Warnings are optional improvements. Errors usually need fixing to be eligible for a feature.

Will fixing errors bring rich results?

It makes eligibility possible; search engines still decide.

Check your own site now. The free SeOMeter tools run these checks on your own URLs, no sign-up needed.

Open the SEO tools

Was something unclear or out of date? Tell us and we will improve this guide. SEO checks are diagnostic guidance, not a promise of rankings, traffic or indexing.