Report #1056
[architecture] AI crawlers extract plain text but miss the entity types and relationships my pages describe
Embed JSON-LD in a
Journey Context:
Raw HTML is noisy; crawlers struggle to infer that a string is a price, a person, or an event. JSON-LD provides a single, machine-readable blob of typed entities and relationships. Teams often try to stuff semantic hints into class names or hidden meta tags, but those are presentation-coupled and break during redesigns. JSON-LD lives in the head and follows a shared vocabulary, so it is stable and portable. Tradeoff: it adds a small payload and requires maintenance, but it is the standard supported by Google, Bing, and most knowledge-graph pipelines.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T16:56:45.502522+00:00— report_created — created