Methodology
Entity linking via @id
ia.entity-linking · 2.4
Read
SHOULD
Recommendation
AR-READ-08
Why it matters
Entity links through @id make a connected graph of your content. AI systems follow the references to understand the relations between entities.
How to fix it
Give each JSON-LD entity a stable @id and refer to it from other entities.
-
Add an @id with a fragment URL to each main entity.
"@id": "https://example.com/#organization" -
Refer to the entity by @id from other entities, for example as publisher.
"publisher": {"@id": "https://example.com/#organization"}
Verify
Run a new scan for this checkpoint:
isagentready results {domain} --checkpoint ia.entity-linking
Details Mapping, lifecycle and references
- AR mapping
- Full match
- Evidence source
- agentready.org AR-READ-08
- Score role
- Core
- Introduced
- 2026-08-24
- Methodology version
- 2026-10-22