[MohamedH1998]

Summary

• A <link rel="canonical"> authored in a page's or the site's head is now the page's only canonical. Nimbus no longer emits its own beside it.
• og:url and the structured data's url follow the authored canonical.
• A site path in the authored link is resolved against site, with base added once, the way socialImage is.

Before → after

---
title: Mirror
head:
  - tag: link
    attrs: { rel: canonical, href: https://origin.example/mirror }
---

<!-- before -->
<link rel="canonical" href="https://docs.example.com/mirror/">
<meta property="og:url" content="https://docs.example.com/mirror/">
<link rel="canonical" href="https://origin.example/mirror">

<!-- after -->
<link rel="canonical" href="https://origin.example/mirror">
<meta property="og:url" content="https://origin.example/mirror">

No config, API, type or user-owned file changes. Pages that author no canonical are unchanged. A route that computes a canonical passes it as a head element.

Checks

• pnpm --filter @cloudflare/nimbus-docs typecheck: pass
• pnpm lint: pass
• test/head-seo-build.test.ts (4 tests, with new assertions for an absolute canonical, a site path, a site path under base, and pages without one): pass. The new assertions fail on main with two canonical links.
• test/api-query-versions-build.test.ts, test/api-page-assets-build.test.ts (the other head assertions): pass

[cloudflare-workers-and-pages]

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://fix-authored-canonical.nimbus-docs.com (commit adbb51d)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status	Deployment URL	Commit	Updated (UTC)	See this deployment's details
Build: Success ✅ Deployment: Success ✅ View logs ↗	https://c99a7f5f.nimbus-docs.com	adbb51d	2026-10-26T13:59:37.702Z	Visit the dashboard ↗