.well-known

/.well-known/ is a standard URL prefix for publishing site metadata at predictable locations.

RFC 8615 defines the prefix, and the IANA registry records registered uses. Examples include security.txt and openid-configuration. Each registered resource has its own format and purpose.

Some API and agent discovery documents use this prefix. Others are proposals or conventions. Check the documentation for the specific resource instead of assuming that every file under .well-known is a standard.

Request the published URL and inspect the result. A framework can return an HTML application shell for a missing metadata file, even with a successful status code. Verify the content type and body as well as the status.

Frequently asked questions

Which .well-known files does my site need?

Use the resources relevant to services you actually offer, such as an API catalog or identity-provider configuration. Their presence alone does not establish AI visibility.

Should I copy llms.txt under .well-known?

The proposal permits /llms.txt and subpaths such as /docs/llms.txt. If a workflow needs another location, serve one maintained version or redirect rather than keeping separate copies.

Related

More terms