Medium issue
Invalid structured data after template edits
Structured data breaks when templates emit malformed JSON-LD, stale entity fields, or schema that no longer matches visible page content.
Why it matters
Structured data helps machines understand the page. Broken JSON-LD or schema that no longer matches the visible content can remove eligibility for rich presentation and make debugging search appearance harder.
Common signals
- JSON-LD scripts contain malformed JSON or unsafe interpolation artifacts.
- Required schema fields disappear after a component refactor.
- The structured entity describes content that is not visible on the page.
Stable fix pattern
- Generate JSON-LD from typed page data rather than hand-assembled strings.
- Escape script-breaking characters before inserting JSON-LD into HTML.
- Keep schema types aligned with actual visible content and page intent.
How SitePulse will monitor this in v1
- Detects missing or malformed structured-data payloads.
- Flags changed structured-data presence between scans.
- Keeps structured-data findings separate from unrelated title or metadata checks.