Skip to main content

Filter SEO URLs

This section describes the settings for SEO friendly layered navigation URLs module that makes standard URLs more SEO valuable and human-readable.

These settings are located in Stores -> Configuration -> Filter SEO URLs.

tip

To apply the settings, clear the Magento cache after making any changes to the options below

General settings​

  • Enable SEO friendly URLs: activates SEO-friendly URLs for layered navigation. This feature works with default Magento or Mirasvit Layered Navigation only.

URL structure​

  • URL format: URL format for filters:
    • Short: displayed as category/option1-option2-option3.
    • Long: displayed as category/attr1/option1-option2/attr2/option2-option3.
  • Separator for filter names: separator between words in complex filter names:

    • Do not use a separator: combines filter names without separation (e.g., Style General becomes /stylegeneral).

    • Use "_" as a separator: places an underscore _ between words.

    • Use "-" as a separator: places a hyphen - between words.

      warning

      Using the hyphen as a word separator has limitations. Since it is also used as an option separator, aliases like weight-height and single weight may not be correctly recognized by the SEO filter route handler.

    • Use capital letter as a separator: converts /stylegeneral to /styleGeneral.

      long_url_filter_underscore

      Long URL format with use _ as a separator and filter prefix

  • Use prefix for filters: adds custom prefix before filters in URLs to improve readability. For example, with the prefix filterprefix, a URL with applied filters will appear as /tops-men/filterprefix/material/cotton.html.

Rewrite configuration​

This section of configurations is used to adjust alias generation basing on the default option name or the name used for a specific store view. It can be helpful when encountering issues with filtering by inconsistent alias or to order all aliases to correspond one format.
An alias is the name of a filter option used in the URL and is stored in Stores -> Attribute -> Product -> AttributeName -> SEO Filters tab -> URL Alias field.

alias_example

Alias for the attribute option. When filtering by this option URL will be .../gear/bags/aliasforyoga.html

  • Rewrite alias source: the source for URL rewrite aliases:
    • Store view label: uses store-specific labels set in appropriate fields of attribute's options for URL aliases.
    • Default (admin) label: ensures consistent aliases across all views, by generating aliases using the value from the 'admin' field of the attribute's options.
  • Remove existing aliases: button removes all aliases and regenerates them in the scope defined by the Rewrite alias source setting. Be aware that all custom aliases will also be deleted. When the process is complete, a notification appears: All (number) attribute and option aliases were removed. Aliases are automatically generated during next filter usage.

remove_existing_aliases_button

Remove Existing Aliases button and notification