Product Canonical Manager: setup and help

Quick start

  1. Install the ZIP in Modules > Module Manager and click Configure.
  2. Open Improve > Canonical Manager > Settings > Configuration and review Canonical URLs and Exclusions.
  3. Open Canonical Rules and add a Rule Name with a narrow Target Entities selection.
  4. Choose Action, fill Custom Canonical URL when required, and set Noindex, Nofollow, Priority, and Active as needed.
  5. Save and open the targeted entity page in each relevant language.
  6. Inspect its canonical and robots tags in page source, then check an untargeted page.

Setup manual

Install and open the module

Upload the ZIP in Modules > Module Manager > Upload a module. Install it and click Configure. The dashboard is under Improve > Canonical Manager. Open Canonical Rules to manage rules and Settings > Configuration for global URL settings.

Requires PrestaShop 1.6.1 or later and PHP 7.1 or later.

HTML changes require the theme to provide a standard HTML head section ending in </head> through actionOutputHTMLBefore.

Configure canonical URL conventions

Open Settings > Configuration > Canonical URLs.

Setting Default What it does and when to change it
Force Lowercase URLs Yes Convert the path in a recognized canonical tag to lowercase. Disable if your actual routes require mixed-case paths.
Force Trailing Slash No Add a slash to a canonical path unless it has a file extension, such as .html or .php. Enable only when that matches your actual destination URLs.

These settings can process an existing canonical on supported entity pages without creating a special rule. They do not rename routes or create redirects.

Configure Exclusions

Setting Default What it does
Strip Pagination from Canonical No Saving this switch does not remove pagination parameters from canonical URLs.
Strip URL Parameters utm_source,utm_medium,utm_campaign,utm_term,utm_content,fbclid,gclid,msclkid Remove the listed query parameter names from a recognized canonical tag.

Enter comma-separated names in Strip URL Parameters. For example:

utm_source,utm_medium,utm_campaign,utm_term,utm_content,fbclid,gclid,msclkid,affiliate_id,newsletter_id

If you deliberately need pagination parameters removed, add p or page to that list. The stored pagination switch alone does not implement this behavior. Save and inspect the resulting canonical.

Create a canonical rule

Open Canonical Rules and add a rule.

Field New-rule default What to enter
Rule Name Empty An internal label for the rule.
Target Entities Empty selector Select an entity type and explicit targets. An unscoped selector for its entity type can match all of that type.
Action Override existing canonical Choose how to supply the canonical URL.
Custom Canonical URL Empty Full destination URL for Use custom URL. Fill the required shop languages.
Noindex No Replace or insert the first recognized robots meta tag with a noindex directive.
Nofollow No Add the nofollow directive through the same robots tag path.
Priority 10 Higher numbers run first.
Active Yes Disable a rule without deleting it.

Available action values are:

Visible action Stored value Behavior
Override existing canonical override Use the entity's own clean PrestaShop URL, replacing a recognized existing canonical or adding one when missing.
Add canonical only if missing add_missing Add the entity URL only if a canonical tag is absent. Global URL cleanup can still modify an existing canonical.
Use custom URL custom Use the multilingual custom URL, replacing a recognized canonical or adding one when missing.

Rules support products, categories, CMS pages, manufacturers, and suppliers. Product targeting can include category, manufacturer, and supplier conditions. Review the selected scope before saving a rule that could affect many pages.

Matching rules are read by descending priority. Processing stops once a matching rule supplies a canonical URL. Robots flags collected before that stop apply with it. Do not rely on every lower-priority rule contributing robots directives.

For example, a custom URL rule can produce:

<link rel="canonical" href="https://yourshop.com/main-product">

Enabling both robots switches produces:

<meta name="robots" content="noindex, nofollow">

This replacement does not merge all previous robots directives. Review any existing directives you need to retain.

In multistore, matching includes rules for the current shop and rules stored with shop ID 0, which apply across shops. Both scopes use the same descending priority order; a shop-specific rule does not automatically outrank a global rule. Set Priority deliberately when both can match. Processing stops at the first matching rule that supplies a canonical URL, so lower-priority robots flags after that point are not applied.

Review advanced entity targeting

Use the Back Office entity selector for normal setup. A stored selector can target products in categories 12 and 18 while excluding product 145:

{
  "products": {
    "groups": [{
      "include": {"method": "by_category", "values": [12, 18]},
      "excludes": [{"method": "specific", "values": [145]}]
    }]
  }
}

This illustrates stored data, not a separate import screen. Verify actual matches on the storefront after changing targeting.

Verify storefront output

Start with one product rule. Save it, open that product, and view page source. Find the canonical tag inside the head. Compare its URL with the intended live destination.

Test a page with an existing canonical and one without it when using Add canonical only if missing. Test the same entity in every active language when using a custom URL. A missing custom translation should not be assumed to inherit another language's URL.

Check the robots tag when Noindex or Nofollow is enabled. Open an untargeted entity too, to confirm the rule scope. The module processes supported entity detail pages. It does not provide the same handling on arbitrary home, search, or custom module pages.

The module does not generate or replace hreflang tags. Use your shop's separate hreflang implementation if you need language alternates.

The dashboard reports active rules, entity coverage, recent rules, and current canonical settings. It is an overview, not proof that your theme output was changed.

Troubleshoot rules

If nothing changes, confirm the rule is active and matches the current entity and shop. Check whether a higher-priority rule already supplies a canonical. Clear any page cache and inspect source again.

Confirm the page passes HTML through actionOutputHTMLBefore and contains a normal head section. The tag-editing code recognizes specific link and meta tag forms. Unusual attribute order or custom markup may need investigation.

If URL cleanup has no effect, check the existing canonical tag and parameter names. The module edits the canonical tag, not the browser address. It does not alter friendly URLs, product names, catalog records, .htaccess, or robots.txt.

Deleting a product, category, CMS page, manufacturer or supplier removes rules attached directly to it. Review saved selections in broader rules after deleting an entity.

Disable or uninstall

Disable the module in Module Manager to stop HTML changes while retaining rules. Your core and theme then supply their normal SEO tags.

Uninstall removes the module menu, settings, admin preferences, and canonical rule tables. Export any rule data you need first. Catalog URLs and records are not rewritten by this module.

Questions

No questions about this module yet

Ask anything about installation, compatibility or setup. Answers appear here.

Known Issues

6

Administration labels remain untranslated

ResolvedUpdated:
Fixed in: 1.2.7
Some administration labels stayed in the source language despite available translations.

Damaged translated text

ResolvedUpdated:
Fixed in: 1.2.2
Some translated administration labels displayed damaged text.

Canonical target picker does not load

ResolvedUpdated:
Fixed in: 1.2.3
The entity picker could fail to load when choosing a target for a canonical rule.

Administration search can stop loading

ResolvedUpdated:
Fixed in: 1.2.1
Administration search could stop working after the installation dependencies were refreshed.

Missing administration and storefront styling

ResolvedUpdated:
Fixed in: 1.1.11
Some administration and storefront assets were missing after cleanup, leaving affected screens incomplete.

List filters do not narrow results correctly

ResolvedUpdated:
Fixed in: 1.1.7
Filtering canonical rules in the back office could return incorrect results.

Feature Requests

5

Implemented

Canonical URL rules

Implemented
Set canonical URL rules for products, categories, content pages, brands and suppliers.

Updates from the back office

Implemented
Check for and install module updates from the back office.

Multilingual administration

Implemented
Use the module administration in French, German, Spanish, Italian and Polish.

Combined license overview

Implemented
View license information alongside other installed mypresta.rocks modules.

Combined license and support activation

Implemented
Activate the module license and assign support in a single action.

Changelog

v1.3.02026-04-20

  • Addedadmin menu management via MenuInstaller for streamlined module setup
  • AddedLicense management tab with key management and renewal options
  • Addedself-healing integrity checks for automatic diagnostics and repair
  • Addedcomplete FR/DE/ES/IT/PL translations
  • Improvedadmin list columns with visual badge indicators and multiselect filters
  • Improvedsettings form organization with tabbed layout
  • Fixedadmin list filters — sorting, searching, and filtering now work correctly on all columns
Older releases

v1.1.82026-03-13

  • Addedcomplete FR/DE/ES/IT/PL translations

v1.2.02026-02-06

  • AddedPrestaShop 9 and Hummingbird theme compatibility
  • Addedbulk canonical override via CSV import and export for large catalogs
  • Improvedcategory canonical management to handle root and nested sub-categories independently
  • Fixedcanonical URL containing double slash when PS base URL is configured with trailing slash
  • Addedaudit log showing active overrides, who set them, and when they were last modified

v1.0.02025-11-06

  • Initialrelease of Product Canonical Manager
  • InitialOverride canonical URLs for products and categories from back office
  • InitialMulti-language support: configure canonical per language independently
  • InitialPrevents duplicate content penalties from faceted navigation and sorting parameters

v1.1.02025-08-21

  • Addedper-product and per-category canonical override fields in back-office edit forms
  • Addedcanonical tag support on manufacturer and supplier listing pages
  • Improvedcanonical URL generation to strip session ID and pagination query parameters
  • Fixedcanonical tag not injected on pages served by PS full-page cache

Demo

Test the full module before you buy

Buy a licence later and keep your settings.

  • Your 30-day demo Test it on your own shop for 30 days from the first install.
  • Ready demo shop Explore a ready demo shop in your browser.
  • No registration No account, email or store domain needed.
Launch demo shop

By downloading, you accept the demo terms and privacy policy.

By opening this demo you accept the demo terms and the privacy policy.

Loading...
Back to top