Skip to content
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.

  1. Add an @id with a fragment URL to each main entity.

    "@id": "https://example.com/#organization"
  2. Refer to the entity by @id from other entities, for example as publisher.

    "publisher": {"@id": "https://example.com/#organization"}

Test it with the free tool

Verify

Run a new scan for this checkpoint:

isagentready results {domain} --checkpoint ia.entity-linking
Details Mapping, lifecycle and references
AR mapping
Full match
Score role
Core
Introduced
2026-08-24
Methodology version
2026-10-22

Checkpoint data (JSON)