ADVERTISEMENT · ADS HELP SUPPORT THE FREE TIER

← Back to SEO LearnNOTABIS SEO / LEARN

Structured data · 8 September 2026

Invalid JSON-LD: How to Diagnose and Fix Structured Data Syntax

JSON-LD is structured data embedded in a page as JSON. NOTABIS reports invalid JSON when the structured-data payload cannot be parsed as valid JSON.

Quick answer

Make the JSON-LD payload valid JSON first, then validate whether its schema and properties suit the page. Syntax validity is necessary but does not guarantee eligibility for enhanced search features.

What the issue means

JSON-LD is a JSON object placed in a <script type="application/ld+json"> element. Invalid quotes, trailing commas, unescaped characters, template output, or incomplete variables can make the payload impossible to parse.

Why it matters for SEO

Invalid structured data cannot be reliably consumed as structured data. Fixing syntax does not guarantee rich results, rankings, or traffic; eligibility also depends on the content, feature requirements, and search-engine policies.

How NOTABIS detects it

The invalid-jsonld rule is page-scoped and medium severity when structured data is not valid JSON. The rule checks JSON validity; it is not a complete schema eligibility review.

How to check it yourself

View the delivered HTML, copy each JSON-LD script payload, and parse it with a JSON parser. Also inspect the browser console and a current structured-data testing tool. Test the rendered response, not only the template source.

How to fix it

Generate JSON with a proper encoder rather than string concatenation. Escape dynamic values, remove trailing commas, emit valid UTF-8, and ensure optional fields are omitted or encoded correctly. Revalidate after deployment and confirm the structured data describes visible page content.

This is parseable JSON-LD syntax; schema suitability and search-feature eligibility still need separate checks:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Example Company",
  "url": "https://example.com/"
}
</script>

When this is intentional or does not need fixing

A page may have no structured data at all; that is different from emitting invalid JSON-LD. Optional or experimental markup should not be retained in a broken state merely to satisfy a catalogue check.

Related issues

Review JSON syntax separately from valid JSON-LD, structured data and JSON-LD, and Google’s structured-data policies for the search feature you are targeting.

Run a NOTABIS audit

NOTABIS identifies pages where the delivered JSON-LD cannot be parsed, allowing you to trace the problem to its template or data source.

Measure before you change

See which issues affect your site.
Run a NOTABIS audit ↗