What are Link headers, and how do they help AI agents?
A Link header is a pointer your server sends alongside a page, saying "there is a related resource over here". When it points at your sitemap or a description of your site, an agent learns where your map is from the response itself, without reading the page or guessing addresses.
What it actually is
Pages can link to related resources in their HTML, but the web's linking standard also lets a server put the same links in the response headers, the small envelope of information that arrives before the page. Each link carries a relation saying what kind of thing it points to: a sitemap, a description of the resource, the documentation for an API.
Why it matters
Agents are economical. Many make a quick request, look at what came back, and decide what to fetch next. A header that points at your sitemap or a description of your site hands them the next step in the first response, before they have parsed anything, and it works for every kind of file — including the ones that are not HTML and have nowhere to put a link.
What good looks like
Your responses carry a Link header pointing at the discovery resources you actually have — the sitemap, a description of the site, an API catalogue if you publish one — each with the relation that names it. Performance hints and platform boilerplate can sit in the same header; they just do not count as discovery.
Being honest about it
This is optional, and we treat it as a suggestion rather than a requirement: agents can still find a sitemap through robots.txt or a well-known address, so its absence leaves nothing unreadable. It is on the report because it is cheap once your hosting allows custom headers, and it is the one place a machine is told where your map is before it has read a single page.
Where most sites go wrong
The common case is a site that does send Link headers, but only the ones its platform adds by itself: hints to connect to a font server early, or a pointer to the platform's own programming interface. Those are useful for other reasons and tell an agent nothing about where your content is mapped. The other is a header pointing at a sitemap that has since moved.
Not sure where yours stands?
A free scan checks this and everything else in about 20 seconds — no signup. Or if it's already flagged and you'd rather it were simply handled, we do that too.
Flagged for this one? We handle it. No pitch, just a plain-English chat.
Book a call