The builder

The builder edits one filter set next to a live page of the shop. It opens from a set’s name in Filters → Filter sets → Sets, or under Filters → Filter sets → Builder. Choose what the builder edits at the top of the column switches to another set.

The screen has two parts:

the column on the left, with the tabs Groups, Panel and Behaviour, and the set’s Skin for the preview;
the stage on the right: a real page of the shop, drawn with the draft.

Save draft keeps the changes; Publish puts them in the shop. The … menu holds Full preview ↗ (the page in its own browser tab), New set…, Import…, Rename…, Duplicate, Where it shows…, Export JSON, Show all and Delete set. History opens the published versions beside the stage.

The stage

The stage shows the page with the set’s panel exactly as the shop draws it.

Control	Effect
Desktop, Tablet, Phone	The device the stage draws. Settings that differ per device are edited for the device shown.
Edit	A click selects a group or a part of it to set it up; a double click opens its settings.
Preview	The stage works as the shop: choose values to see the products and the counts change.
Page of the stage	The page drawn: Sales channel, Category (empty: Whole catalogue (all products)), Search phrase, Page layout (Sidebar column or Full width) and Visitor (Guest, Customer group, Rule).

The page layout follows the page’s layout in Shopping Experiences. Switching it here changes only the stage, to see the other layout.
With a customer group or a rule as the visitor, prices and assignments bound to them come out as the shop’s.
A note under the stage names the set shoppers see on that page today.
The stage draws the draft even in a sales channel where P2Lab Filter is still switched off.

In Edit mode a group on the stage has its own menu: Rename, Move up, Move down, Hide in the set, Look, Remove from the set. A group added by other properties offers Pin to the set, Skip in automatic mode and Automatic mode settings.

Above the panel the stage lists what keeps a group out of sight on this page: hidden in the set, no products with the group here, a single value only, the group’s page visibility, a deleted property group, a source listed twice, a property group Shopware does not filter by. To check before publishing collects the set’s issues, for example All (AND) on a variant option, counts switched off, too many groups for the bar, or more count queries per page than MySQL is allowed (12).

The column and the stage share undo and redo, and keyboard shortcuts for removing, renaming, moving, saving and switching Edit and Preview. Search settings finds a setting on every tab.

Groups

The Groups tab lists the set’s filter groups. The order is the order in the shop.

A click selects a group, on the stage too; a double click opens its settings.
The eye hides a group in this set without removing it.
The groups are moved by dragging. The line Under ‘More filters’ marks where the groups visible at start end; dragging it changes Groups at start.
Each row names the kind and how many products of the stage’s page have a value: “Property · 412/530 products here”.
The row menu holds Group settings, Edit source ↗, Duplicate and Remove from the set. A source can be in a set only once.

Adding groups

Add groups opens a window in two steps: the Type of source, then the Sources of that type.

Type of source	Holds
Product data	Manufacturer, price, rating, free shipping, weight and size
Properties and options	The shop’s property groups, those that build variants too
Custom fields	The product’s custom fields a filter can read
Computed	In stock, on sale, new, category
Compatibility	What the products fit: a catalogue chosen level by level
Composite filter	One group of sections, each a property group or two as tabs

Each source shows how many products of the stage’s page have a value. Back keeps what you ticked, so one run can add sources of several types. Search all sources searches every type at once. A group without products can be added and set up too; it shows in the shop once products get values. New groups go to the end of the list.

Kinds of group

Each kind of source draws its own kind of group:

Kind	Draws	Display types
Manufacturer	A list of values	Auto, List, Radio, Pills, Dropdown, Tiles, Logos
Tags	A list of values	Auto, List, Radio, Pills, Dropdown
Property, Variant option	A list of values	Auto, List, Radio, Tiles, Swatches, Logos, Pills, Dropdown, Slider
Custom field	Depends on the field: a selection draws a list, a number a range, yes/no a switch, a date a span from – to	Auto, List, Radio, Pills, Dropdown for a selection
Category	The categories as links or as a filter	List, Radio, Tree, Menu, one level, Menu, fly-out
Price, Dimension	A range	Slider
Rating	Stars	Stars, Radio
Free shipping, Availability, On sale, New	One switch	Switch
Search in results	A field of words that searches the name, number and brand	—
Compatibility	A catalogue’s levels, one after another	see compatibility in the shop
Composite filter	Sections of property groups	see composite filters

Auto shows swatches for colours, tiles when no value is longer than System → Storefront filter allows (4 characters unless set), and a list otherwise. Logos and swatches show each value’s image from Shopware, or your own from Sources → Values, per language. Built in, a manufacturer shows as a list ordered by name, tags as pills, colour property groups as swatches, the price and dimensions as sliders, the rating as stars with one choice.

A property group shown as a Slider uses the values whose names start with a number (“1500 W”, “2016”); the others stay out.

Group settings

A group’s settings open with a double click. The Source row on top names the source; Edit source ↗ opens it. A group’s source changes only by adding another group.

Each setting shows where its value comes from. An inherited value comes, in this order, from the group’s source (Sources), from the Shop defaults for its kind, from the Shop defaults for every group, or from the built-in values. A value set in the group overrides them; the link icon of the row takes it back to the inherited one.

Only the settings that mean something for the group’s kind and display show. A setting that does nothing in the current combination is locked, with a note saying why and what to change.

Setting	Effect
Label	The group’s name in this set, per language. Empty uses the source’s name.
Help text	Shown above the group’s values; a switch shows it as the tooltip of a ”?” at its end.
Show header	The group’s head with its name. Always on where the head is the only way to the values: the bar’s pill, a drawer’s row.
Icon	Before the group’s name: in its header, a switch’s row, the bar’s pill and a drawer’s row. No icon keeps out one the shop defaults give its kind.

Display

Setting	Effect
Display	The display type (see the table above).
Columns	1 to 6 equal columns, or Automatic: tiles, swatches, logos and pills as many to a line as fit; a list, radios and stars as the skin says.
Name, Logo height	With Logos: the name Hidden, Below the logo or Beside the logo; each logo scaled to this height and shown whole.
Tree opens, Guide lines	A category tree: The way to the chosen, Only the first level or Every level; lines between the levels.
Siblings too	The menu of category links shows the current category’s siblings around it, not only its subcategories.
On a phone	Categories in the drawer: One level at a time or Tree.
Presentation	In place, or Popover that opens on a click. Only where the panel stands in a column.
At start	As the panel, Expanded or Collapsed, per device.
In a drawer with levels	On a drawer’s list of every filter: Own screen (a row that opens the group’s screen) or In place. By default in place on a computer, its own screen on a tablet and a phone; ranges and switches in place everywhere.

Choice

Setting	Effect
Categories work as	Automatically (links to the subcategories on a category page, a filter on search results), Links or Filter.
Between values	Any (OR): a product with any chosen value. All (AND): a product with every chosen value.
Multiple choice	Off: the group picks one value.
Select all / none	A three-state box in the group’s header.

All (AND) is offered only where a product can have several values of the group: properties and tags. A manufacturer, a custom field and the categories always filter with Any (OR), because a product has one of them. On a variant option All (AND) finds nothing: two colours of one product are two different variants. A Radio and Stars pick one value, so these settings are locked there.

Values

Setting	Effect
Values in this set	All, Only the ticked ones or All but the ticked ones of the source’s values. A value the shopper chose stays shown, so old addresses keep filtering.
Ticked values	The values of the stage’s page to tick. With none ticked, every value shows.
Value order	Shopware position, Name, Most products or Custom. The values keep their places while the shopper filters.
Own order	With Custom: the values dragged into the order the shop shows. Values added later follow the list.
Selected first	Chosen values come first as the page loads; they do not jump while the shopper picks.
Value groups	The source’s value groups: in a list a row over its values, in other displays one item.
Value groups open at start	Those with a choice, None or All.
Show more after	The number of values shown before “Show more”, per device.
Long lists	Auto, Show more, Scroll and load or Show all in the drawer. Auto shows “Show more” for a few values and, from the number set in System → Storefront filter (30 unless set), scrolls in its own box and loads the next values.
Values per load	How many values a scrolling list loads at a time.
Maximum height	The height of a scrolling list.
Search from	From this many values the group offers a search field; 0 = never. Not for tiles, swatches and logos, which show every value.
Without products	Dim or Hide a value no product of the current choice has.
Counts	The number of products beside each value.

The source’s own hidden and pinned values (Sources → Values) apply to every set. A category group keeps the shop’s category order when it shows links, a tree or a menu.

Range

Setting	Effect
Range control	Slider and fields, Fields, Slider or Ranges (a list of ready ranges).
Fields	Above the slider or Below the slider.
Step	The slider’s step; 0 = automatic. With Ranges: the narrowest range.
Round bounds	The slider’s ends rounded.
Histogram	Bars over the slider show how the products spread across the range under the other choices. Counted after the page loads; on MySQL one query per bar.
Counts, Without products	With Ranges: the products per range, and what a range without products does.
Unit	For dimensions, number custom fields and properties shown as a slider. The price’s unit is the channel’s currency.

How the numbers read (thousands separator, decimals, short forms) and the ready ranges belong to the source: Sources → Units and Ranges. See sources.

Counts

A switch’s group has one setting here: Counts. In the bar a switch’s pill shows no count; it shows in All filters and in a phone’s sheet.

Visibility

Setting	Effect
Hide with one value	A group whose products all have the same value takes no place.
Without products	A rating’s stars out of reach: Dim or Hide.
Shows on pages	Only on some categories or landing pages, or everywhere but them. A category includes its subcategories if you tick it. The same for computer and phone.
Placement	For a page with two filter elements in Shopping Experiences, one in the sidebar and one above the listing: Everywhere, Sidebar column or Bar above the listing. With one element the group shows all the same; the drawer of tablets and phones shows every group once.

A compatibility group has its own block, Compatibility; see compatibility in the shop.

Composite filters

A Composite filter is one group made of sections. Each section is a property group, or two property groups as tabs (one scale of a size and a finer one). A composite group has the tabs Sections, Head and Visibility.

Add section picks the section’s source. Add tab (second source) adds the second one. A section has its own Label (translated; empty: the source’s name) and Icon; each tab has a Tab label and shows its values as tiles, a list or pills.
Sections as: Sections is an accordion, each section a scale of its own (a product with any chosen value). Chain is one list after another (gender, then type, then size): the next opens once the one before has a choice and offers what that choice leaves; a change above clears the lists below. In a chain a step uses its section’s first source.
Sections open at start: Those with a choice, None or The first one (sections only).
The head always shows a counter: the sum of the chosen values of all sections.
A section without products on the page disappears by itself; a filter without any section too. A source can be in the set once, so sources of other sections and groups are locked in the choice. The address has no new parameters: each source writes its values as it does on its own.

Where one product fits several things at once (a part for several car models), a chain of properties cannot say which goes with which. Use a compatibility catalogue for that.

Other properties

The row Other properties in the list stands for property groups the shop adds by itself on each page. It can be dragged to where those groups stand among the set’s own.

Setting	Effect
Add other properties automatically	On: property groups the set does not list come by themselves.
From which groups	All properties or Only the chosen ones.
Only from	The property groups that may come. New property groups do not come by themselves while this list decides.
Skip	Never added automatically. A group on the set’s list still shows, and so does a shopper’s choice in the address.
Minimum coverage	The share of the page’s products that must have the property (30 % unless set).
At most	The most groups added (6 unless set).
Values with products, at least	A group with fewer values that have products on the page takes no place (2 unless set).

Under the settings, Other properties on the stage’s page lists what the automatic groups add and why they leave the rest out (skipped, not under Only from, under the threshold, the most groups shown already, too few values). Pin makes a group the set’s own, where the other properties stand; Skip keeps it out; Take again undoes a skip. An automatic group takes the skin’s look; add it to the set’s groups to give it a look of its own.

Panel

The Panel tab sets where and how the panel stands.

Setting	Effect
Layout	Per device. Computer and tablet: Auto or Drawer; phone: Sheet from the bottom or Sheet from the side. Auto: in a sidebar section of the layout (Shopping Experiences) the panel stands in its column, elsewhere as the bar over the list. Drawer: always behind the Filters button. By default Auto on a computer, Drawer on a tablet, Sheet from the bottom on a phone.
Sticky, Offset from top	The panel stays in view while the page scrolls; the offset is added to the height of the theme’s sticky header.
Groups at start	How many groups show before More filters (8 unless set).
Expanded at start	First three, All or With a choice: the groups standing in place, in a column and on a drawer’s list.
Hidden groups load	With the page or When opened.
Clear group (×)	A × to clear one group. In the bar a pill’s popover has its own Clear.
‘Clear’ as a link	In the panel’s title row and the head of a bar pill’s popover, while something is chosen.
‘Clear’ as a button	Beside Show N in the foot of a drawer, a sheet and a bar pill’s popover.
Heading	The title row over the groups: As the layout has it (shown in the column, not in the bar), Shown or Hidden.
Title, Icon	The panel’s title (also the drawer’s) and the icon before it.
Icons in the drawer’s head	The panel’s icon in the head of a drawer and a phone’s sheet, a group’s icon on its own screen.
Chips	The chosen filters Above the list or In the panel. In the bar the chips stand under the pills.
Chips in the sheet	Fixed or Scrolling.
Sorting in the sheet	The listing’s sorting inside a phone’s sheet, where the page offers more than one.

The stage shows the panel as Column on the left, Column on the right, Bar over the list, Drawer, Sheet from the bottom or Sheet from the side, as the layout and the page give it.

The panel’s colours, sizes and shapes come from the skin. The Look section under a group’s settings and under Panel changes the skin of the channels that use it; the change is saved and published with this set. See skins.

Behaviour

Setting	Effect
Apply	At once: every click updates the list. After a pause: the list waits until the shopper stops clicking. With a button: changes gather until Show N products. On phones the sheet always applies with its button.
Pause	With After a pause: how long the list waits (800 ms unless set).
Merge window	Clicks this close together go to the list as one request (250 ms unless set); 0 sends every click at once.
‘Show N products’	With With a button in a column: At the window’s foot or Under the groups.
Counts	The number of products beside the values, for every group that does not set its own.
Values without products	Dim or Hide, for every group that does not set its own. A category group hides them by default.
Scroll to the list	After applying: When off screen, Always or Never.
Hints on an empty result	When a choice leaves no product, the list says which choice to remove instead of the core’s notice.
Usage statistics	Records the shoppers’ choices for insights.

Shop defaults

Filters → Filter sets → Shop defaults opens the builder for the values every set inherits. It has the tabs Panel, Behaviour and Source kinds, and no groups of its own; Groups from the set picks the set the stage shows.

On Source kinds, Every group sets what all groups get; each kind (Manufacturer, Property, Price, …) sets what the groups of that kind get unless their source or their set says otherwise. Property and variant option groups shown as colours have an entry of their own. The property groups that build variants come before Property.

The shop defaults are published like a set, with their own versions.