README

Magento 2 Filter SEO Extension: Clean Layered Navigation URLs and Per-Filter Meta (Hyva + Luma)

Turn every layered navigation filter into a real, indexable URL. Panth Filter SEO rewrites /women/tops.html?color=49&size=166 into /women/tops/color-red-size-xl.html so Google treats each filtered page as its own landing page. Pair it with per-category, per-store meta title and meta description overrides so every filter combination has its own bespoke <title> and <meta description> instead of duplicating the parent category.

Product page: kishansavaliya.com/magento-2-filter-seo.html

Quick Answer

What is Panth Filter SEO? It is a Magento 2 extension that rewrites layered navigation filter URLs from query strings into clean path-based URLs and lets you set custom meta titles and descriptions for every filter combination on every category page.

What does it add to my store?

• Clean filter URLs that replace ?color=49&size=166 with /color-red-size-xl.html, one crawlable URL per filter combination.
• Per-option rewrite slugs so you control exactly what each attribute option looks like in the URL, scoped per store view.
• Per-filter meta overrides for <title>, <meta description>, and <meta keywords> at the category + filter + store level.
• Auto-inject filter labels into the category title and description when no explicit override is set.
• Admin grids for managing rewrite slugs and filter meta records with a View on Storefront action on every row.

Which themes are supported? Both Hyva and Luma. The rewrite happens at the router and URL-builder layer, not in templates, so there are no theme overrides to manage.

What does it need? Magento 2.4.4 to 2.4.8, PHP 8.1 to 8.4, and the free mage2kishan/module-core package.

Need Custom Magento 2 Development?

Get a free quote for your project in 24 hours for custom modules, Hyva themes, performance work, M1 to M2 migrations, and Adobe Commerce Cloud.

Kishan Savaliya Top Rated Plus on Upwork 100% Job Success - 10+ Years Magento Experience Adobe Certified - Hyva Specialist

Panth Infotech Agency Magento Development Team Custom Modules - Theme Design - Migrations Performance - SEO - Adobe Commerce Cloud

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

Table of Contents

• Who Is It For
• Key Features
• Compatibility
• Installation
• Configuration
• How It Works
• FAQ
• Support
• About Panth Infotech
• Quick Links

Who Is It For

• Fashion, apparel, and lifestyle stores where shoppers filter by color, size, and style and each combination deserves its own landing page.
• Electronics and home goods stores with large catalogs and many filterable attributes, where duplicate filter URLs hurt search rankings.
• Multi-language or multi-store setups that need localized URL slugs, for example color-black in English and farbe-schwarz in German.
• SEO-focused merchants who want to turn high-converting filter combinations like "Red Dresses" or "Size XL Jackets" into properly indexed pages with custom meta.
• Hyva storefronts that need filter SEO handled below the theme layer with no Alpine.js or template changes required.

Key Features

Clean Filter URLs

• Path-based filter URLs instead of query strings. /women/tops/color-red-size-xl.html instead of /women/tops.html?color=49&size=166.
• Two URL formats - short (/color-red-size-xl.html) or long (/color/red/size/xl.html). Pick the one that fits your URL strategy.
• Configurable separator character so you can use - or another character between attribute and value in the short format.
• Per-option rewrite slugs so color=49 becomes black and size=166 becomes xs. Each slug is stored in the panth_seo_filter_rewrite table.
• Store-scoped slugs - the same option maps to black on an English store and schwarz on a German store. A global default (store 0) covers any store without its own row.
• Auto-slug for new attribute options - when an admin adds a new swatch or dropdown option, the module saves a slug row automatically so you never need to backfill manually.
• Graceful fallback - if no slug exists for a store, the module silently falls back to the native ?color=49 query-string URL so filtering still works.

Per-Filter Meta Overrides

• Custom meta title, meta description, and meta keywords for every {category} x {attribute option} x {store view} combination, stored in panth_seo_category_filter_meta.
• Breadcrumb priority field lets you set which override wins when multiple filter rules match the same page.
• Auto-inject filter labels - when no explicit override is set, optionally append active filter names like "Color: Red, Size: XL" to the category title and description automatically.

Admin Grids and Storefront Preview

• SEO Filter URL Rewrites grid under Panth Infotech in the admin sidebar. Lists every {attribute, option, store} row. Edit the slug, toggle active status, and hit View on Storefront to verify the live URL instantly.
• Category Filter Meta grid lists every {category, attribute, option, store} meta override. Create and edit overrides without leaving the admin.
• View on Storefront on every grid row and every edit form opens the correct live filtered URL on the right store domain in a new tab.

Theme-Agnostic and Multi-Store Ready

• No frontend template overrides - the rewrite happens at the router and URL-builder layer so it works identically on Hyva and Luma.
• Scope-aware configuration - all settings support website and store view scope so each store can opt in or out independently.
• No redirect overhead - the router resolves filter segments directly to the underlying Magento category controller. No .htaccess rules needed.

Compatibility

Requirement	Versions Supported
Magento Open Source	2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8
Adobe Commerce	2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8
Adobe Commerce Cloud	2.4.4 to 2.4.8
PHP	8.1.x, 8.2.x, 8.3.x, 8.4.x
Hyva Theme	1.0+ (theme-agnostic, no template overrides)
Luma Theme	Native support
Required Dependency	mage2kishan/module-core (free)

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-filter-seo
bin/magento module:enable Panth_Core Panth_FilterSeo
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release from Packagist or from the product page.
2. Extract it to app/code/Panth/FilterSeo/ in your Magento install.
3. Make sure Panth_Core is installed too (required dependency).
4. Run the commands above starting from bin/magento module:enable.

Verify Installation

bin/magento module:status Panth_FilterSeo
# Expected: Module is enabled

After install, open:

Admin -> Panth Infotech -> Filter SEO -> Filter URL Rewrites

Configuration

Go to Stores -> Configuration -> Panth Infotech -> Filter SEO.

Setting	Group	Default	Description
Enable SEO-Friendly Filter URLs	Filter URL Rewrites	No	Master toggle. When Yes, layered navigation builds clean path-based URLs. When No, native ?color=49 query strings are used.
URL Format	Filter URL Rewrites	Short	short = /color-red-size-xl.html. long = /color/red/size/xl.html.
Separator Character	Filter URL Rewrites	-	Character between attribute and slug in short format.
Enable Filter Page Meta Override	Filter Page Meta	No	Master toggle for meta overrides. When Yes, stored overrides replace the default category meta on filtered pages.
Inject Filter Name in Meta Title	Filter Page Meta	No	When no override exists, appends active filter labels like "Color: Red, Size: XL" to the category meta title.
Inject Filter Name in Meta Description	Filter Page Meta	No	Same as above but for <meta description>.

All settings respect website and store view scope so each store can be configured independently.

How It Works

1. A shopper clicks a filter on a category page. The module's URL builder injects the filter segment into the layered navigation link, producing /women/tops/color-red-size-xl.html instead of ?color=49.
2. The request hits the custom FilterRouter which extracts the filter segment from the path, reverse-looks up each slug in panth_seo_filter_rewrite, and forwards the request to Magento's standard category controller with the correct filter parameters applied.
3. The storefront renders the filtered category page at the clean URL. No redirect happens, so no crawl budget is wasted.
4. If a meta override exists in panth_seo_category_filter_meta for that {category, attribute, option, store} combination, the MetaInjector fires on the catalog_controller_category_init_after event and writes the custom title and description into the page head. If no override exists and auto-inject is on, it appends the active filter labels to the default category meta instead.
5. The View on Storefront button in the admin grids calls the same URL builder to produce the correct live link for whichever store the record belongs to.

FAQ

Does it work on Hyva themes?

Yes. The rewrite happens at the router and URL-builder layer, not in templates. There are no Hyva or Alpine.js-specific changes in this module. It works on any theme.

Will it break existing category URLs?

No. The module only adds the filter segment to category URLs when a filter is active. Unfiltered category URLs (/women/tops.html) are unchanged.

Do I need to reindex after enabling?

You need to flush the configuration cache after saving settings. A full catalog_url_rewrite_category reindex is only needed if category URLs were already broken. The filter slugs take effect on the next request without a reindex.

What happens if I have no slug for a particular attribute option?

The module falls back silently to the native ?color=49 query-string URL. Filtering still works, the URL just isn't clean until you add a slug in the rewrite grid.

Can I use different slugs per store view?

Yes. A row with store_id = 0 acts as a global default. Add a row with the specific store ID to override it for that store. You can have color-black in English and farbe-schwarz in German.

Will it slow down category pages?

No. Slug lookups are memoised per request via RewriteRepository so the router cost is one SELECT per unique store per request. There are no additional queries per filter combination.

Can I set meta for only a few filter combinations and leave the rest alone?

Yes. Meta overrides are fully optional on a per-combination basis. Any filtered page without an override falls back to the default category meta, or appends filter labels if auto-inject is enabled.

Does it handle multi-select filters?

Yes. Multiple active filters produce one combined path segment, for example /color-red-size-xl.html for two active filters at the same time.

Does Panth Filter SEO need Panth Core?

Yes. mage2kishan/module-core is a free, required dependency that Composer installs for you automatically.

Screenshots

Admin Configuration

All six settings at Stores -> Configuration -> Panth Infotech -> Filter SEO.

SEO Filter URL Rewrites Grid

Rewrite grid	Edit form

Category Filter Meta Grid

Meta grid	Edit form

Support

Channel	Contact
Product Page	kishansavaliya.com/magento-2-filter-seo.html
Email	kishansavaliyakb@gmail.com
Website	kishansavaliya.com
WhatsApp	+91 84012 70422
GitHub Issues	github.com/mage2sk/module-filter-seo/issues
Upwork (Top Rated Plus)	Hire Kishan Savaliya
Upwork Agency	Panth Infotech

Response time: 1-2 business days.

Need Custom Magento Development?

Looking for custom Magento module development, Hyva theme work, store migrations, or performance tuning? Get a free quote in 24 hours:

     

About Panth Infotech

Built and maintained by Kishan Savaliya (kishansavaliya.com), a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency that builds high quality, security focused extensions and themes for both Hyva and Luma storefronts. The extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management, with each module built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on our Magento extensions page or on Packagist.

Quick Links

Resource	Link
Product Page	magento-2-filter-seo.html
Packagist	mage2kishan/module-filter-seo
GitHub	mage2sk/module-filter-seo
Website	kishansavaliya.com
Free Quote	kishansavaliya.com/get-quote
Upwork (Top Rated Plus)	Hire Kishan Savaliya
Upwork Agency	Panth Infotech
Email	kishansavaliyakb@gmail.com
WhatsApp	+91 84012 70422

Ready to make your filtered category pages rank?

SEO Keywords: magento 2 filter seo, magento 2 layered navigation seo, magento 2 clean filter urls, magento 2 filter url rewrite, magento 2 seo friendly filter urls, magento 2 filter meta title description, magento 2 category filter meta, magento 2 layered navigation url rewrite, hyva filter seo, hyva layered navigation seo, luma filter seo, magento 2 filter page seo, magento 2 faceted navigation seo, magento 2 filter slug, magento 2 filter url slug, magento 2 layered navigation clean urls, magento 2 filter page meta title, magento 2 filter page meta description, magento 2 filter landing page seo, magento 2 filter duplicate content, magento 2 filter url canonical, magento 2.4.8 filter seo, php 8.4 filter seo, mage2kishan filter seo, panth filter seo, panth infotech, hire magento developer, top rated plus upwork, kishan savaliya magento, custom magento seo development