Crystal Ball checks covered

JSONLD_INVALID

Guide detail

Choose Your Technical Level

This setting applies to the meaning, causes, and fix sections. Your choice carries to other Fix Library guides on this device.

Practical explanations and page-specific steps. Recommended for most readers.

What the flag means

Crystal Ball flags invalid JSON-LD when it finds structured data that cannot be parsed or interpreted reliably. The script may contain invalid JSON syntax, or it may be valid JSON with properties and values that do not meet the expected schema.

A parser may ignore malformed markup even while the visible page looks normal. Separate syntax errors from missing recommended fields: the first can break the data block, while the second may only limit its completeness or eligibility for a particular feature.

Common causes

Common causes include missing commas, curly quotes from copied text, unclosed braces, invalid URLs, placeholder values, duplicate scripts from multiple plugins, unsupported property formats, or CMS fields that output blank values.

What to check next

Check whether the issue appears on one page or every page using the same template. Review recent content, theme, plugin, deployment, and server changes, then compare the live output with a known-good page.

How to fix it

Confirm the warning first and make a backup before editing the live site. If the change involves templates, code, DNS, redirects, or server settings, switch to Intermediate or ask for help before proceeding.

  • Custom HTML/static: Copy the JSON-LD into the Rich Results Test or Schema Markup Validator. Fix missing commas, bad quotes, invalid URLs, and placeholder values.
  • WordPress: Temporarily disable duplicate schema plugins or review plugin settings. If Yoast is active, start with its Schema documentation before adding custom code.
  • Shopify: Check theme JSON-LD snippets and app-generated schema. Duplicate Product schema and broken Liquid variables are common failure points. Use the Rich Results Test after theme edits.
  • Wix: Open the page's structured data markup settings and validate the pasted code before saving. Wix documents structured data markup.
  • Webflow: Check custom code fields for smart quotes, missing braces, or CMS fields that output blank values. Test the published URL, not only the Designer preview.

Need help?

If the fix gets murky, visit Support and send the details. Bug reports and Crystal Ball questions are free support. Implementation and development work may be paid support, but we will tell you clearly before anything becomes paid. No surprise invoices from the tower.