Structured data

Structured data is machine-readable markup, usually JSON-LD, that states what a page is about in a defined vocabulary rather than leaving it to be inferred from the prose.

Two rules decide whether it helps or hurts. It has to match the visible page, because markup describing content the page does not contain is a manual action risk rather than a technicality. And an entity should be defined once and referenced by @id everywhere else, because a validator that does not resolve the reference will propose completing it, which writes a second conflicting definition and breaks the graph it was trying to fix.

Required properties are the ones that gate a rich result. A validator that reports every optional property as a warning trains people to ignore it.

Generate valid JSON-LD from a page

Related

Tell us about your business.

Thirty minutes with a specialist. You leave with a plan, whether or not you hire us.