Schema Fix System¶
Status: Active (recovered from rogue-agent incident, ongoing maintenance) Project: SEO · Website
What this is¶
Sitewide JSON-LD schema markup — LegalService, LocalBusiness,
FAQPage, Article — that feeds rich results to Google Search. Lives
primarily in WPCode snippets and in SA Template pages' embedded JSON-LD.
Early 2026 had several critical incidents including a rogue-agent
event that stripped all sitewide schema, followed by ongoing fixes as
encoding/rendering bugs surfaced.
Major incidents¶
Schema Audit: Rogue Agent Stripped All Schema — Restoration Needed (April 2) — a previous agent session overwrote or removed sitewide schema markup on a large number of pages. Kickstarted an emergency restoration and triggered guardrails in the schema-touching skills.
Schema Fix: WPCode Snippet 43605 - Semrush Errors + Encoding Battle — Semrush flagged malformed JSON-LD on the BSG snippet. Root cause: double-encoded HTML entities in the WPCode JSON field. Fixed by re-entering the raw schema block, not by escaping.
Schema Markup Audit: Initial Audit Errors + Corrected Gap Analysis (March 6) — first structured audit of schema coverage across the site. Surfaced gaps that the later April fixes addressed.
SA Template Conversion (Final 3 Pages) + Sitewide Schema Cleanup — the final SA Template conversion doubled as a schema cleanup pass.
SEO Audit + Largest Trucking Overhaul + FAQ Schema Batch (April 14) — recent work on FAQ schema across trucking pages as part of a larger SEO overhaul.
Types of schema used¶
- LegalService / LocalBusiness — firm-level, injected via WPCode
- FAQPage — per-page, embedded in the SA Template body
- Article / BlogPosting — blog-style injury content pages
- Breadcrumb — navigation hierarchy
Common bugs¶
- Double-encoding. WPCode's JSON field auto-escapes, and if you paste already-escaped content you get double escapes that break JSON-LD parsers. Always paste raw.
- Mixed schema types on one page (LegalService + FAQPage) — Google handles this fine but Semrush's validator flags it. False positive.
- FAQ schema without matching on-page content — Semrush and Google both flag this. FAQ items in the schema must exist as visible HTML on the page.
Sources¶
- Schema Audit: Rogue Agent Stripped All Schema — Restoration Needed (2026-04-02)
- Schema Markup Audit: Initial Audit Errors + Corrected Gap Analysis (March 6, 2026)
- SA Template Conversion (Final 3 Pages) + Sitewide Schema Cleanup
- Schema Fix: WPCode Snippet 43605 - Semrush Errors + Encoding Battle
- SEO Audit + Largest Trucking Overhaul + FAQ Schema Batch (April 14, 2026)