Technical readiness resource

How to fix missing or broken JSON-LD on your website

Check JSON syntax, choose schema types that match the page, and keep machine-readable details aligned with visible content.

JSON-LD describes facts about a page or entity in structured form. Start by fixing parsing errors, then check the type and factual values. Valid markup does not guarantee a rich result or an AI citation.

Separate broken JSON from incomplete details

A parsing failure can come from a trailing comma, unmatched quote, or HTML inserted into the JSON. A missing-field warning is a different problem: the JSON may parse correctly but lack a useful detail. Fix syntax first so the rest of the data can be inspected.

Describe the page you actually have

Use an appropriate type and real facts. An organization example needs your actual name and URL; an article needs its actual title and author information. Do not invent reviews, ratings, dates, or credentials to fill a template.

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "name": "Your actual business name",
  "url": "https://your-site.example"
}
</script>

Verify changes in the delivered page

Inspect the public HTML after deploying the change, not only the source file in your editor. Check that CMS plugins and custom code have not produced conflicting blocks. Use a validator appropriate to the intended structured-data feature, then compare the data with what readers can see.

Where SiteReadyFor.SI’s schema check helps

SiteReadyFor.SI parses JSON-LD, flags malformed blocks, and checks common recommended fields. Paid reports include starter templates to review. It is a basic technical check rather than exhaustive validation of every schema vocabulary or search feature.

References

Check your own website next.

Run an on-demand audit across crawler access, content retrieval, JSON-LD, sitemaps, and llms.txt.

Start a scan