Website Spec
← Agent Readiness
Required

Stable URLs

URLs are public contracts. Once published, they should keep working. Breaking them invalidates citations, bookmarks, links, and agent caches — and is almost always avoidable.

What it is

A stable URL is one that keeps resolving to the same content over time, or — when content moves — redirects permanently to its new location. The principle was set out by Tim Berners-Lee in 1998 in Cool URIs don't change and has only become more important as agents, archives, and citations multiply.

A URL is a public contract. Once you publish one, every link, bookmark, citation, RSS reader, search index, and agent cache assumes it will keep working.

Why it matters

A site that reorganises its URLs every release teaches the web not to trust it.

How to implement

Design for permanence from the start:

When a URL must change, redirect:

For deletions, a clean 410 Gone is more honest than a soft 404 or a homepage redirect.

Common mistakes

Verification

Sources