Magento 2 Canonical URL Extension

Why Canonical URLs Matter

Canonical URLs are essential for SEO success in e-commerce. Your store likely has many ways to access the same content: products appear in multiple categories, filtered views create parameter-heavy URLs, and pagination splits content across pages. Without proper canonical URL implementation, search engines see these as separate pages competing for rankings. Canonical URLs tell search engines which version is the "official" one, consolidating ranking signals and preventing duplicate content issues.

CMS Page and Home Page Canonical URLs

Home Page Trailing Slash: Configure whether your home page canonical URL includes or omits a trailing slash, ensuring consistency with your preferred URL format.

Custom CMS Page Canonicals: CMS pages receive the Canonical URL attribute, allowing you to specify alternative canonical URLs or cross-domain canonical URLs for landing pages, promotional content, or other special pages.

Product Page Canonical URLs

Control exactly how product canonical URLs are generated based on your site structure and SEO strategy:

Category Path Control: When category paths appear in product URLs, choose how the canonical URL handles them:

• Minimum category nesting: Use the shortest category path (e.g., /electronics/phone.html instead of /electronics/mobile/smartphones/phone.html)
• Maximum category nesting: Use the full category hierarchy for canonical URLs
• No category path: Generate canonical URLs without any category information

This flexibility ensures your canonical URLs align with your preferred URL structure for search results.

Parent-Child Product Relationships: For Configurable, Grouped, and Bundle products, use the parent product's canonical URL for all child product variants. This is particularly useful when child products are individually accessible on your storefront but should consolidate their SEO value to the parent product. Search engines will understand that all variants represent the same product offering.

Custom Canonical URLs: The extension adds a Canonical URL attribute to products, giving you complete control when needed. Use this attribute to:

• Point to a different entity (product, category, CMS page) as the canonical version
• Specify cross-domain canonical URLs for multi-site setups
• Handle special cases requiring manual canonical URL assignment

Important: Don't manually enter the product's own URL in the Canonical URL attribute. For products in multiple categories with different URL paths, use the extension's configuration settings to define which URL should serve as the canonical URL. This approach also ensures compatibility with our Hreflang Extension.

Category Page Canonical URLs

Categories present unique canonical URL challenges with pagination and filtering:

Paginated Pages: Control how pagination affects canonical URLs. Choose whether to include page parameters in canonical URLs or point all pages to the first page. Additionally, add rel="prev/next" link elements to help search engines understand the relationship between paginated pages, improving crawl efficiency and content indexing.

Filtered Pages: Define how filter parameters impact canonical URLs:

• Include filter parameters: Each filtered view has its own canonical URL
• Exclude filter parameters: All filtered views share the base category canonical URL
• No canonical URL: Don't add canonical URLs to filtered pages at all

This control lets you implement the canonical strategy that best fits your filtering implementation and SEO goals.

Custom Category Canonicals: Like products, categories gain a Canonical URL attribute for special cases requiring manual canonical URL specification or cross-domain canonical URLs.

Cross-Domain Canonical URLs

For businesses operating multiple domains or migrating between domains, cross-domain canonical URLs are essential. Configure cross-domain canonicals through:

• Global configuration settings for site-wide rules
• Canonical URL attribute for individual products, categories, and CMS pages

This functionality is crucial when maintaining multiple domains with shared content, ensuring search engines understand which domain should appear in search results.

Magento GraphQL Support for PWA

The extension includes full Magento GraphQL support, enabling seamless integration with Progressive Web Application (PWA) storefronts. A free GraphQL support module is available in our GitHub repository, providing all extension features through GraphQL queries and mutations. This allows PWA storefronts to leverage complete canonical URL functionality, maintaining SEO best practices in headless commerce implementations.

Smart NOINDEX Integration

The extension intelligently handles pages marked with NOINDEX directives. Since canonical URLs guide search engines to preferred versions of indexed content, they're unnecessary - and potentially confusing - on pages that shouldn't be indexed at all. The extension automatically excludes canonical URLs from NOINDEX pages, maintaining clean, logical SEO signals.

Use our Meta Robots Extension to configure robots meta tags across your site for complete indexing control.

Comprehensive Integration

The Canonical URL Extension works seamlessly with our other SEO tools:

• Hreflang Extension: Coordinate canonical URLs with international language targeting
• Meta Robots Extension: Automatically handle canonical URLs on NOINDEX pages
• Rich Snippets Extension: Ensure structured data uses canonical URLs
• XML Sitemap Extension: Include canonical URLs in sitemap generation

For complete SEO optimization, consider using the Magento 2 SEO Extension, which includes canonical URL functionality along with additional SEO features in one unified solution.

Benefits for Your Business

• Eliminate Duplicate Content: Consolidate ranking signals to your preferred URLs
• Improve Search Rankings: Stronger, consolidated signals lead to better positions
• Optimize Crawl Budget: Direct search engines to your most important pages
• Maintain Clean Indexes: Control exactly which URL versions appear in search results
• Support Complex Structures: Handle multi-category products, filters, and pagination effectively
• Enable Multi-Site SEO: Manage canonical URLs across multiple domains