Extended redirect

Instructions for Extended Redirect

What the add-on does

The add-on performs permanent 301 storefront redirects using active rules for the current company. It compares the entire source path, without wildcards or regular expressions.

Where to find the add-on

Rules: Website → SEO → Extended Redirect. This is separate from the standard 301 redirects entry. The matching setting is in the Extended Redirect add-on settings. Menu access depends on user permissions.

Create a rule

1. Select the intended company or storefront context.
2. Add a rule: source URL, for example /old-page; destination URL, /new-page or a complete address such as https://example.org/new-page.
3. Choose active status and save. Use disabled status to turn a rule off temporarily.
4. Verify it on that company's storefront. Avoid duplicate active source paths for the same company: duplicate priority is not defined.

Use an internal store path for the source, not another site's address. Leading and trailing source slashes are normalized. Internal destinations without ? or # receive a trailing slash; those with either retain their specified path form. For example, /index.php?dispatch=products.search remains a URL with parameters.

GET parameters

The option to ignore GET parameters when matching URLs is off by default. Thus /old-page?utm_source=test does not match a /old-page rule: the complete source with parameters is required. Parameter order is not normalized either.

When enabled, the request portion after ? is excluded from matching. Save sources without parameters: /old-page will also match /old-page?utm_source=test. This setting affects all add-on rules. Incoming parameters are not automatically appended to the destination; include required parameters there explicitly. Browsers do not send the fragment after # to the server, so it cannot be used for source matching.

Edit and delete

The list supports address edits, status changes and deletion of selected rules. Search filters destination addresses. Company-context operations are restricted to that company's rules; the general administrative context differs from an individual company. A company 0 rule is not a universal fallback for all storefront companies.

How to check operation

1. Open the source on the intended storefront. Inspect the 301 response and destination in the browser network panel.
2. Test a source with GET parameters with the setting off and on.
3. Check an internal destination with query parameters and an external destination if used.
4. Disable the rule and repeat in a clean browser session: browsers may cache 301 responses.

Do not redirect a page to itself or create a chain that returns to its source: the add-on does not automatically prevent loops. For a missing redirect, check status, company, exact path and GET matching mode.