Sitemap and Canonical Release Checklist
A growing wiki needs search hygiene. Each article should publish as one clear URL with matching metadata, internal discovery, and sitemap coverage.
Required page signals
- A unique, stable slug.
- A useful title and meta description.
- A canonical URL that points to the article route, not the site root.
- Sitemap inclusion after publication.
- Internal links from the wiki index, category, or related-page blocks.
Release checklist
- Validate JSON and duplicate slugs.
- Fetch
/wiki/<slug>locally and confirm HTTP 200. - Inspect the canonical link in rendered HTML.
- Search the sitemap for the new URL after deploy.
- Run representative search queries that should surface the page.
Pitfalls
- Dynamic article pages can accidentally inherit a root canonical if the renderer does not pass the article path.
- A sitemap entry is not useful if the route 404s in production.
- Noindex is correct for private previews but wrong for intentionally public wiki guides.
Verification steps
- Check at least two new article URLs live after deployment.
- Fetch the live sitemap and confirm the new URLs are present.
- Use a mobile screenshot to verify the page is readable, not just indexable.
