DF Faceted SEO — Faceted Search & SEO for PrestaShop
Indexing rules for filtered URLs and SEO landing pages, added on top of the filter engine in place, for PrestaShop 1.7.8, 8 and 9.
DF Faceted SEO 2.0.0 decides how the filtered URLs of your product lists are indexed and serves landing pages that you write. It works on top of the faceted search engine already installed (usually ps_facetedsearch) without replacing it. Compatible with PrestaShop 1.7.8, 8 and 9, PHP 7.1 to 8.5.
What the module does
On categories, brands, suppliers, new products, prices drop and best sales, the module reads the filters chosen by the engine in place and decides, for each filtered URL:
- the
meta robotstag: index, or noindex,follow; - the canonical;
- the hreflang tags (removed from filtered URLs, since no equivalent is guaranteed in other languages);
- a 301 redirect to the normalized filter order;
- optionally, a 404 response for a combination with no product.
It also serves landing pages: one page per commercial selection (category and filters), with a clean URL per language, an H1, a title, a meta description and a text written by you.
The module does not change robots.txt, .htaccess or friendly URLs. It creates no page automatically. It promises no traffic, no rankings and no indexing: search engines decide.
Requirements
- PrestaShop 1.7.8 to 9.x, PHP 7.1 to 8.5.
- A faceted search engine active on product lists: ps_facetedsearch, or any engine exposing the core’s standard facets.
- Friendly URLs enabled for landing pages.
Installation
- Upload
dffacetedseo-2.0.0.zipin Modules > Module Manager, then click Install. - Open Improve > Faceted SEO > Dashboard.
- Read the Engine and coexistence and Alerts blocks.
After installation, no filtered URL is indexable: the default rule is noindex,follow with a canonical to the unfiltered list, as PrestaShop 9 already does.
Upgrading from 1.0.2
Make a backup, then upload the 2.0.0 zip from the module manager. The upgrade script runs on its own:
- rules are converted (“canonical self” becomes indexable, “disallow” becomes noindex with its blacklist);
- landing pages keep their IDs, slugs and the
landingprefix; - statistics are kept;
- page text is cleaned (scripts are removed);
- empty tables, the Search Console key and old files are removed; the old AJAX endpoint answers 410.
Dashboard

The dashboard shows the key figures, the detected engine, the state of neighbouring modules and the alerts. Examples of alerts: the PrestaShop 9 robots.txt blocking ?q= while a rule opens combinations, a landing page without text, two pages on the same selection, settings to check in dfallinoneseo or datafireflyhreflang.
Settings
- Listing mode: Automatic (paused when dffacetedfilter is active) by default, Always on or Off (landing pages only).
- When no rule applies: noindex (recommended) by default.
- Max facets combined (1) and Min products (3): limits applied by default.
- Combination without products: noindex by default, or HTTP 404 (Google recommendation).
- Facets never indexable: price, weight, availability, condition, extras and sub-category are ticked by default.
- Filtered URL equal to a landing page: Canonical to the landing page by default, or 301 redirect to the landing page.
- URL prefix:
selectionon a fresh install,landingkept after an upgrade. Changing the prefix keeps the former URLs as 301s. - Min words of unique text to be indexable (60) and Min products to be indexable (3).
- Keep for (days): 180 days for statistics.
- When the module is uninstalled: keep (default) or delete everything.
Sorted lists (?order=) and pages 2+ of filtered URLs are always noindex, with a canonical to the unsorted page. The noindex is written in the page: a URL blocked by robots.txt is not crawled, so its noindex is never read.
Indexation rules

In Indexation rules, a rule applies to the whole shop or to a category, including its sub-categories if you tick it. For a filtered URL, the most specific active rule wins: the category’s rule, then the rule of the parent category covering its sub-categories, then the general rule. Priority breaks ties between two rules of the same scope.
With the May be indexed decision, the URL is indexable only if every condition is met:
- Max facets combined: with 1, “Red” is indexable, “Red + 42” is not;
- Max values per facet: with 1, “Red” is indexable, “Red or Blue” is not;
- Min products;
- Indexable facets (whitelist);
- Only these values (optional) and Never these values;
- first page only.
Otherwise the URL gets noindex,follow and a canonical to the unfiltered list. The Never indexed decision forces this result.
Open few combinations: those that match a real search of your customers and list enough products. Then check them in the simulator.
Simulator

Simulator: would this URL be indexed, and why? uses the same decision function as the shop. In Compose a combination mode, choose a category and filters: the result shows the decision, the meta robots, the canonical, the product count, the rule applied and the steps checked.

In Test a real URL mode, paste the URL of a list or a landing page of the shop: the page is actually requested and the tags found in the HTML are shown. Several canonicals or several meta robots tags are flagged. Only the shop’s domains are accepted.
Landing pages
List and suggestions

Landing pages lists your pages with their status, product and word counts, and languages. The Suggestions from popular combinations block offers the combinations used at least 5 times, with enough products and no page yet. Create a draft pre-fills an inactive draft: you write the text and decide to publish. Export (JSON) and Import copy pages and rules from one shop to another; everything imported arrives as a draft or inactive.
Editor

- Product selection: category (or none), sub-categories included or not, filters of the selection. The number of matching products is shown live.
- Content and SEO by language: name, URL, H1 heading, Meta title, Meta description, introduction above the products and text below them. Leave the name empty to not publish a language (404, no hreflang).
- Search result preview: approximate preview, the search engine may rewrite the title and the description.
- Checklist (current language): title of 30 to 60 characters, description of 70 to 160 characters, unique text of at least 60 words, at least 3 products, no other page with the same selection.
- Publication: Online and Indexable (when the checklist is met).
HTML allowed in texts: paragraphs, subheadings, lists, links, bold and italics. Scripts, styles, forms and event attributes are removed on save and on display.
URLs and redirects
The URL follows the pattern /language/prefix/slug, for example:
https://your-shop.com/en/selection/leather-trail-shoes
Renaming the slug or changing the prefix keeps the old URL as a 301. A page that is disabled, deleted, missing in the language or whose category is inactive answers 404. A page that does not meet the checklist is served with noindex. Each pagination page has its own canonical.
In the shop

The theme displays the products, sorting and pagination. The module adds the Refine this selection block: color swatches, features, brands, price slider, counters, active filters as badges and Clear all.

The list updates without reloading, through the theme’s mechanism; the robots and canonical tags in the head follow. The structured breadcrumb (BreadcrumbList) is the theme’s: the module adds one only when the theme does not provide it.


On mobile, filters open in an accessible panel: filter groups in fieldsets, result count announced to screen readers, focus kept and closing with Escape.
Internal linking

The Popular selections block at the bottom of a category links to its indexable landing pages. It can be turned off in the settings.
Popular combinations

Popular combinations lists the filter combinations chosen by visitors, with visit and product counts and the decision taken at the last visit. Create a draft opens a landing page draft from a row.
- Data stored: combination, counter, product count, decision and dates. No IP address, no customer, no session, no user agent.
- A browser is counted once per combination; known bots and direct hits without interaction are ignored.
- Automatic purge after 180 days without a visit (configurable); the Purge button deletes earlier.
Sitemap and neighbouring modules
- dfsitemap receives the indexable landing pages, one URL per language. Without dfsitemap, a sitemap is available at
/module/dffacetedseo/sitemap. - dffacetedfilter: in automatic mode, listing rules pause because it already handles the SEO of its filtered URLs; landing pages stay active.
- dfallinoneseo: if you open combinations, turn off its “noindex on faceted pages” and “faceted canonical” options. It keeps og:url on the unfiltered URL.
- datafireflyhreflang: depending on its configuration, it may remove the hreflang tags of landing pages; the dashboard tells you.
Measured performance
PrestaShop 9.1.5 test shop in debug mode, 3,000 fictitious products, average of 20 requests:
| Page | Module disabled | Module enabled |
|---|---|---|
| Category of 3,000 products | 0.273 s | 0.258 s |
| Filtered category (1,000 products) | 0.240 s | 0.242 s |
| Landing page of 1,000 products, cold / warm cache | — | 0.278 s / 0.211 s |
On product lists the difference stays within measurement noise: the module runs no search there and claims no speed gain. The landing page engine runs 11 SQL queries whether the page lists 6 or 1,000 products.
Troubleshooting
A landing page answers 404
Check that the page is online, that its name is filled in this language, that its category is active and open to the visitor’s group, and that friendly URLs are enabled. Then clear the cache.
A landing page stays noindex
The checklist is not met (text under 60 words, fewer than 3 products) or the indexing box is unticked. The real URL test of the simulator gives the reason.
Rules have no effect on categories
dffacetedfilter is active in automatic mode, or the listing mode is set to Off (landing pages only). The dashboard says so.
Two canonicals in the page
Another module or the theme adds its own tag. The real URL test lists the tags found; turn off the matching option in the other module.
Uninstalling
The choice is made beforehand, in When the module is uninstalled: Keep landing pages, rules, redirects and statistics (reinstalling restores them), or Delete everything (landing page URLs will answer 404).
Support
For any question or bug report, write to support@datafirefly.com with your PrestaShop, PHP and module versions and the URL concerned.