Filter sets
A filter set is the shop’s filter panel for a kind of page: the filter groups it shows and their order, the panel’s layout and its behaviour. One set can serve many pages; different pages can get different sets. The sets are managed under Catalogues → Filters → Filter sets → Sets.
P2Lab Filter draws the panel only in sales channels where it is switched on: Filters → Overview → Dashboard, Filters in sales channels. Switched off, Shopware (or the channel’s theme) draws the filters. The switch works at once, without publishing.
What a set holds
Section titled “What a set holds”| Part | What it is |
|---|---|
| Groups | The filter groups in the shop’s order, each reading one source (a property, the manufacturer, the price…), with its own settings. |
| Other properties | Optional: property groups added by themselves on each page, by how many of the page’s products have them. |
| Panel | The layout per device, the groups shown at start, the chips, the heading. |
| Behaviour | When a choice applies, counts, values without products, what happens after applying. |
All of it is edited in the builder.
The list of sets
Section titled “The list of sets”The list shows each set’s Name and technical name, its State, Where it shows, the number of Groups (“4 + auto” when other properties come by themselves) and who Changed it last. The sidebar filters the list by name, state and sales channel.
The row menu holds Open in the builder, Duplicate, Rename, Export JSON and Delete. Import JSON at the top and Export JSON lead to import and export.
A new set
Section titled “A new set”New set asks for a name and a template:
| Template | Starts with |
|---|---|
| Like Shopware today | The same groups as the core’s filters; shoppers notice no change. |
| Fashion | Category, every colour group as swatches, brand and price first; sizes and materials by coverage; then on sale, in stock and new. |
| Electronics | Category, brand, price, rating and stock first; up to 12 technical properties by coverage, colours left out; then on sale, free shipping and new. |
| Empty | No groups; you add them from the sources in the builder. |
The name is seen in the administration and in the version history. The technical name stays when the set is renamed, so export files and integrations still recognise it. A new set starts as a draft without an assignment.
The default set
Section titled “The default set”A fresh install creates the set Standard and assigns it as the default: it shows manufacturer, price, rating, free shipping and every other property group by itself. The default set works wherever no other assignment matches. It is pinned at the top of the list and cannot be renamed or deleted.
Draft and published version
Section titled “Draft and published version”Every change goes to the set’s draft first. The shop shows the published version.
| State | Meaning |
|---|---|
| Draft · not published yet | The set was never published; its assignments take no part. |
| Draft · N changes · in the shop: vN | The shop shows version N; the draft has changes that are not published. |
| Published vN · no changes in the draft | The draft and the shop are the same. |
In the builder, Save draft keeps the changes without touching the shop. Publish makes the draft the next version; filter pages show it as their cache refreshes. Settings that are not allowed, unknown or listed twice are dropped on publishing; if the draft has an error, the builder asks before publishing it anyway.
History in the builder lists the published versions, newest first. A version can be compared with the one before and restored: restoring replaces the draft, and the shop changes only after Publish. Discard draft throws away the changes since the last version. Every set’s versions are also listed under Filters → System → Versions; how many are kept is set under System → Retention.
The Shop defaults (Filters → Filter sets → Shop defaults) have a draft and versions of their own. They hold the values every set inherits; see the builder.
Deleting a set removes its draft and every version. Pages it served get a set of lower priority or the default set. To stop a set without losing it, delete its assignment instead.
Where a set shows
Section titled “Where a set shows”Where a set works is decided under Filters → Where sets show → Assignments. The shop tries the assignments in their order and takes the first that fits the page, the sales channel, the visitor and the day. When none fits, the default set works.
Assignments work as soon as they are saved, without publishing; the set needs a published version. An assignment of a set that was never published starts working with the set’s first publication.
An assignment
Section titled “An assignment”Assign set opens the assignment. Its fields:
| Setting | Effect |
|---|---|
| Set | The set the assignment shows. |
| Place in the order | 1 is tried first. A new assignment goes to the end of the order, above the default set. |
| Sales channels | The channels it works in. None picked means every sales channel. |
| Pages | Categories (category listings) and Search results (every search term). Tick at least one kind of page, or the set shows nowhere. |
| Show when the page has | The page must have one of the list: a category, or a search phrase. Empty: any category, any search. |
| Skip when the page has | The assignment does not apply to a page with any of these. Skipping always wins. |
| Who sees it | A rule from the Shopware rule builder. Empty: every visitor. |
| When | A start and an end date. Empty means no limit. |
- A category under Show when the page has or Skip when the page has includes its subcategories when includes subcategories is ticked.
- A search phrase matches a search for a phrase holding its words in this order: “winter jacket” matches “red winter jacket”, not “jacket for winter”. Upper and lower case do not matter. Phrases only meet search results, so tick Search results for them.
- No page has both a category and a search phrase: an assignment that asks for both never applies.
- There is no device condition. Computer, tablet and phone get the same set; the panel’s layout per device is part of the set.
- The rule is part of the page cache, so a guest’s page and a B2B customer’s page are cached apart. At a date boundary the cache renews itself.
Which set wins
Section titled “Which set wins”For each page the shop goes down the order and judges each assignment:
- The kind of page and Show when the page has must fit the page.
- The page’s sales channel must be one of the assignment’s, if it names any.
- Nothing under Skip when the page has may be on the page.
- The set must be published, and today must lie within When.
- The visitor must meet the rule under Who sees it, if there is one.
The first assignment that passes wins; the ones below it that would also fit lose. If none passes, the default set works. Assignments of equal place keep the order in which they were created.
The rows can be moved with Move up, Move down and Move to place…; the new order works at once.
Landing pages and filter forms
Section titled “Landing pages and filter forms”- A landing page of filters (SEO → Landing pages) gets the set of its category; see landing pages. Shopware’s own landing pages cannot be picked in an assignment yet.
- A filter form placed in Shopping Experiences shows its own set on its tabs; see filter forms.
Checking where sets show
Section titled “Checking where sets show”The other screens of Where sets show answer the question from the page’s side:
- Overview: the set that wins on category pages and search results in each sales channel, branched by rules and dates.
- Categories: the set each category page gets, and why (named by an assignment, below a category an assignment names, skipped, or the default set).
- Check a page: one page, for a visitor and a day, step by step as the shop picks the set, and the groups that show on it.
See coverage for these screens.