Canonical Tags for Astro SEO

A canonical tag tells search engines which URL is the “real” version of a page when multiple URLs could serve similar or identical content. Getting this wrong is one of the more common technical SEO issues on Astro sites, particularly ones with a deploy base path, trailing-slash inconsistencies, or dynamically generated content collections.

Self-referencing canonicals should be the default

Every genuinely unique page should canonicalize to itself — this seems obvious but is easy to get wrong when a layout component builds the canonical URL from a template rather than the page’s actual resolved URL, especially across nested dynamic routes.

Base-path and trailing-slash consistency matters

A site deployed under a subfolder (a staging environment, for instance) needs its canonical URLs built consistently with that base path applied — a canonical tag pointing to the production domain root from a staging build is a real, documented failure mode. Similarly, inconsistent trailing slashes between the actual served URL and the canonical tag can create confusing duplicate-URL signals.

Content collections need deliberate canonical handling

When multiple routes could theoretically serve the same underlying content-collection entry (a redirect stub alongside the real page, for example), only the real, current URL should be canonical — a redirect page should never claim to be canonical for content that’s moved elsewhere.

Pagination needs its own canonical logic

Paginated listing pages (page 2, page 3 of a blog index, for instance) should each canonicalize to themselves, not all point back to page 1 — collapsing them onto page 1’s canonical can cause search engines to miss indexing the content on later pages entirely.

Verify, don’t assume

After implementation, spot-check the actual rendered HTML on a handful of pages — including at least one nested dynamic route and one from a non-production build — to confirm the canonical tag matches what’s actually intended, rather than trusting the template logic without verification.

Where this fits

Canonical tag correctness is a foundational technical detail that prevents duplicate-content confusion downstream. A Free Strategy Audit includes a real check of canonical implementation for a specific site.