How it works

Every filter combination opens at its own URL (/catalog/color-white/brand-nike/), but only the pages you choose with SEO rules are offered to search engines. Other combinations get noindex,follow and a canonical to the catalog page — no junk duplicates in search indexes.

A rule (SEO tab) says: "for these catalog pages, create landing pages from the values of these filters". For example, a "Color + brand" rule for a clothes catalog gives /catalog/red/nike/, /catalog/blue/adidas/ and so on — one page per combination that has products. Rule pages have URLs without filter names and their own title, H1, description and text.

Setup

  1. Enable MODX friendly URLs; the catalog page URL must end with "/".
  2. Put [[!BitFacetSeo]] first in <head> of the catalog template, with the same &set as [[!BitFacet]], and output the placeholders:
    
        [[!BitFacetSeo? &set=`auto`]]
        [[!+bitfacet.title:default=`[[*pagetitle]]`]]
    
    
        

    [[!+bitfacet.h1:default=`[[*pagetitle]]`]]

    [[!+bitfacet.text]] [[!BitFacet? &set=`auto`]]
  3. SEO tab → "Create rule": set, catalog pages (ids; "And subsections of these pages" — the rule applies to nested sections too), filters in URL order, text templates, "In sitemap".
  4. The button in the rule row opens its pages — every landing page with its URL and product count. Any of them can have its own texts or be excluded from indexing.
  5. Add the sitemap to robots.txt: Sitemap: https://your-site/bitfacet-sitemap.xml.

Text templates

The rule fields title, H1, description and text are templates with substitutions:

{pagetitle} {longtitle} {menutitle} {description}catalog page fields
{count}products on the rule page
{values}all values separated by spaces
{ms:color}, {ms:vendor} …caption of the filter value (key as in the set)
|lower, |ucfirstletter case: {ms:color|lower}

Example for the "Color + brand" rule in the Sneakers section:

title:        {ms:vendor} {ms:color|lower} {pagetitle|lower} — buy online
H1:           {ms:vendor} {ms:color|lower} {pagetitle|lower}
description:  {count} {ms:vendor} models in {ms:color|lower}. Free delivery.
text:         

The catalog has {count} {ms:color|lower} {pagetitle|lower} by {ms:vendor}.

Text is HTML; values substituted into it are escaped.

BitFacetSeo placeholders

bitfacet.title, bitfacet.h1, bitfacet.description, bitfacet.textrule page texts (empty on other pages — :default works)
bitfacet.robots, bitfacet.canonicalwhat the snippet already output in <head>
bitfacet.countproducts on the rule page

The snippet outputs <meta name="description">, <meta name="robots"> and <link rel="canonical"> itself. Without a filter in the URL it outputs nothing.

What gets indexed

Rule page with products (and its pages 2, 3…)index,follow, canonical to itself
Rule page with sortingnoindex, canonical without sorting
Rule page without products404
Any other filter combination, ranges, searchnoindex,follow, canonical to the catalog page
Filter in parameters (?f[…], old links)301 to the path URL

The sitemap /bitfacet-sitemap.xml is built on request: only pages of rules marked "In sitemap" that have products, without pages excluded from indexing, up to 50,000 URLs; each context lists its own pages.