Fix guides ยท Emerging standards

Add Link headers for agents

Optional: if you have an API, add a Link header pointing to its description or documentation.

Proposal or draft, no proven ranking benefit

What we check

We check your homepage's Link header for relations such as service-desc, service-doc, describedby or alternate. A preload header alone doesn't count.

11%

of 198 sites we could read pass this.

Why it matters

RFC 8631 defines service-desc, for descriptions meant for machines, and service-doc, for documentation meant for people. It's an Informational RFC, not a standards-track one.

This mostly matters for products with an API. A typical content site can skip it.

How to fix it

  1. Find your API description or documentation URL.
  2. Add the header in your server or CDN config.
Link: </openapi.json>; rel="service-desc"; type="application/openapi+json"

Fix it yourself with AI

Small fixes shouldn't sit in a queue. Give your AI agent one prompt, and it fixes and deploys for you.

PromptShip is made by the team behind this checker.

Sources

Fixed it?

Run your site through the checker, and re-check after you ship to see what improved.

Check my site

Related guides