Use schema.org 'mentions' property to enhance entity clarity in structured data.
- Use schema.org 'mentions' property to enhance entity clarity in structured data2 cited sources1 category
Save for later 0
Use × to move an item here. You can restore it when you’re ready.
Your checks and saved items stay in this browser. Nothing is submitted.
Why this matters
Including the 'mentions' property in JSON-LD structured data clarifies secondary or related entities on a page, helping search engines better understand content context without misleading or inflating relevance.
Hypothetical standard operating procedure
Adapt this example to your site, access, tools, and change process. It is our suggested procedure, informed by the sources below.
- Review main entities discussed visibly on the page.
- Add a 'mentions' array in JSON-LD referencing related entities using schema.org types (e.g., SoftwareApplication) with descriptive names.
- Ensure all mentioned entities correspond to on-page visible content and do not mark hidden or irrelevant elements.
- Validate the structured data using Google's Rich Results Test and Schema Markup Validator tools before deployment.
- Monitor Search Console for structured data errors and rich results status regularly after implementation.
Watch for
Avoid adding 'mentions' for entities not explicitly visible or relevant on the page as it may cause manual actions and reduce rich result eligibility.
Definition of done
Page structured data includes accurate 'mentions' referencing visible related entities, validated with Schema Markup Validator and Rich Results Test, without errors or manual penalties.
Sources & attribution
Original checklist wording and example SOP by Best SEO Checklist, using source-grounded AI assistance. Editorial contact: Ted Kubaitis, @tedkubaitis on Teams. Check current source guidance before implementation.