How to fix “Alternate page with proper canonical tag” on Magento
If Search Console shows “Alternate page with proper canonical tag” on your Magento site, you are in the right place. The page canonicalises to another URL; usually expected. This page covers the causes and a step-by-step fix for Magento. A powerful e-commerce platform (Adobe Commerce) for large catalogs. Layered navigation filters create many parametrised URLs.
Contents
What does this status mean?
This page declares itself a copy of another URL and Google accepts that. It is normal for parametrised and mobile URLs; it is only a problem if you wanted this page indexed.
Likely causes on Magento
- The page canonicalises to another URL on purpose.
- A template or plugin adds a wrong canonical to every page (for example always the home page).
- An AMP or separate mobile version points to the main version.
- Every paginated page canonicalises to page one.
- Magento note: In Catalog > SEO turn on "Use Canonical Link Meta Tag" for categories and products. Dropping the category path from product URLs reduces duplicates.
Step-by-step fix on Magento
- In your Magento admin go to: Stores > Configuration > Catalog > Catalog > Search Engine Optimization and Marketing > SEO & Search.
- In Catalog > SEO turn on "Use Canonical Link Meta Tag" for categories and products. Dropping the category path from product URLs reduces duplicates.
- First decide whether you want this URL indexed; if not, nothing needs doing.
- If you do, change the canonical to point at itself (self-referencing).
- Check the page source to make sure the template is not adding the same canonical everywhere.
- Give paginated pages their own addresses as canonicals.
- After fixing, send the URL for indexing.
Extra checks for Magento
- redirects and 404: Add 301s under Marketing > URL Rewrites. When a product URL key changes, keep the "create permanent redirect" box ticked.
- sitemap: Create the sitemap under Marketing > SEO & Search > Site Map and add it to robots.txt. Tie generation to cron to keep it current.
After fixing
In Search Console start "Validate fix" for this status and resubmit the page with URL inspection. First confirm the blocker is gone with the free Free indexability checker tool; for many URLs follow Bulk URL indexing: how to send thousands of pages to Google. Google makes the indexing decision itself and timing ranges from days to weeks.
More information
Frequently asked questions
Must I fix this warning?
No. If it is deliberate it is working as intended; fix it only on pages that should be indexed.
Why does it canonicalise to the home page?
Usually a plugin or template setting mistake. Every page should reference its own address.
Where are these settings on Magento?
Stores > Configuration > Catalog > Catalog > Search Engine Optimization and Marketing > SEO & Search.