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.
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
- Find your API description or documentation URL.
- 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