agentic‑readiness docs
/
Scan at scale Blog Build one › Run a scan ›

DocsDiscoverabilityHTTP Link header

HTTP Link header

Relations declared in headers, readable without parsing the body.

adoption Web baselinetrend ► flatchecked on every pagechecks 7verified 2026-10-05
Set up HTTP Link header on your site How to send discovery relations in the HTTP response, and which relations agents actually read.
Free Set up Link headers

Why an agent cares

A Link header is the cheapest thing an agent can read: it arrives with the response and needs no HTML parse. A malformed field is worse than none, because a conforming parser drops the whole header rather than the bad part.

Adoption

Web baseline. Standard equipment on the web. Its absence is the exception rather than its presence.

Direction of travel: ► flat, as at .

RFC 8288 is standard HTTP machinery, used for canonical, preload and API pagination.

What we check

Absence is never a finding. Every check below runs only when this technology is detected, so a site that has not adopted this is not assessed on it and appears in no report. 7 of these 7 can fail it. In Lumar these appear on each page's own row.
CheckSeverityRaisesOn whose authority
Link Header Malformed Syntaxmediumconformance, usabilityspecification: Web Linking
Link Header Missing Relmediumconformance, usabilityspecification: Web Linking
Link Header Invalid URImediumconformance, usabilityspecification: Web Linking
Link Header Foreign Anchormediumusabilityspecification: Web Linking
Link Header Insecure Targetmediumusability, security (CWE-319)Lumar readiness bar, beyond Web Linking
Link Header Duplicate Rellowconformance, usabilityspecification: Web Linking
Link Header Invalid Rellowconformance, usabilityspecification: Web Linking

Specifications

DocumentRevisionKind
RFC 8288 — Web LinkingPublished RFCspecification
RFC 9110 — HTTP Semantics (how header values are written)Published RFCspecification
specification.website — agent-readiness link patternsLiving documentguidance

Last re-read against the published documents: .