Product Filters
Filters let customers narrow the product list in the store down to the properties they care about — for example colour, size, brand, price or availability. They are shown in the sidebar on category pages and in search results.
Path: Catalog › Products › Filters › All Filters
The filter system has three parts:
- Filters — your own filters, created from the attributes, parameters, labels and tags of your products
- Filter Groups — optional grouping of filters into named sets
- Static Filters — always-available system filters (category, price, brand, tags, availability)
Where filter values come from
Filters do not define their own values. You create them on top of data your products already have — attributes, parameters, labels and tags, brands, categories and price. So set up product attributes and parameters first and only then create filters from them.
Filters
Path: Catalog › Products › Filters › All Filters
This page lists all the filters you have created. Add new filters with the Add Filter button in the header — it opens the Create Filter page with the Quick Create Filters tool, which creates filters from existing attributes, parameters, labels and tags.
Filter list
You can search and arrange filters with the tools above the table:
- Search — by the filter name or field
- Type — limit to one source type (attribute, parameter, price, category, tag, label)
- Group — limit to the filters in one group
- Sort — by name or display order
You can change the order of filters by dragging (drag-and-drop) — it decides the order in which customers see them.
Creating a filter (Quick Create)
Path: Catalog › Products › Filters › All Filters › Add Filter button
You create a filter by choosing the source it is built from. Sources are grouped as follows:
- Attributes — for example Color, Size, Material. Each attribute shows the number of available values
- Parameters — product parameters (e.g. Material, Country of origin). The values come from the parameters; colour parameters show their values as colour swatches
- Labels — individual labels (new, sale, etc.), or All Labels, which creates one filter from all labels
- Tags — individual tags, or All Tags for one shared filter
Clicking a source opens a window with the settings:
| Setting | Description |
|---|---|
| Filter Display Name | The filter name the customer sees. Entered separately for each language (language tabs). Leave it empty and the source name is used |
| Filter Display Type | How the filter is rendered (see the table below) |
| Show More Limit | How many values are shown before the rest hide under a "Show more" button. Default 5 |
| Closable (Collapsed by default) | Lets the customer collapse and expand the filter |
| Starts Collapsed | If the filter is closable, whether it is collapsed when the page loads |
Display types
| Type | Description |
|---|---|
| Multi Select (Most Common) | Tickable values, several can be chosen at once. The most used type |
| Checkbox (Very Common) | Classic checkboxes |
| Dropdown | Choosing from a dropdown list |
| Range Slider | A from–to slider. Available only for price and numeric attributes or parameters (attributes/parameters whose values are all numbers) |
Range slider
The range slider can only be used for price or for an attribute or parameter whose values are all numeric (e.g. "Memory size" with the values 128, 256, 512). If the source is not numeric, the system does not let you save this option.
Colour parameters
When you create a filter from a Colour-type parameter, the values are shown as colour swatches only with the Checkbox display type. That is why the system sets this display type automatically for a colour parameter.
Editing and filter status
For each filter in the list you can:
- Edit — change the name, display type, group, order and other settings
- Activate / deactivate — a deactivated filter is not shown in the store but stays saved
- Delete — remove the filter permanently
Collapsing settings in bulk
Under More actions ▾ in the page header there are bulk actions that set all filters at once: Set All Closable & Collapsed, Set All Closable & Expanded or Set All Not Closable. You can include the static filters too. Handy when you want all filters in the store to behave the same way.
Filter Groups
Path: Catalog › Products › Filters › Filter Groups
Groups keep related filters together (for example a "Technical parameters" or "Features" group). You then assign a filter to a group when editing it.
When creating a group you set:
| Field | Description |
|---|---|
| Name | The group name (multilingual) |
| Description | An optional group description (multilingual) |
| Icon | An optional group icon |
| Color | An optional group colour (format #RRGGBB) |
| Order | The display order of the group |
| Active | Whether the group is active |
WARNING
A group that contains filters cannot be deleted. First move the filters to another group or remove them from the group.
Static Filters
Path: Catalog › Products › Filters › Static Filters
Static filters are always-available system filters that you do not create from attributes — they are part of the system. They are:
- Category
- Price
- Brand
- Tags
- Availability (stock status)
For each static filter you can change:
| Setting | Description |
|---|---|
| Display name | The name the customer sees (multilingual) |
| Display type | Dropdown, multi select, checkboxes, radio button or range slider |
| Closable | Whether the customer can collapse the filter |
| Starts Collapsed | Whether the filter is collapsed when the page loads |
| Active | Whether the filter is shown in the store |
| Order | Its position among the filters |
Price must be a slider
The Price filter must always use the range slider display type. The other static filters, on the other hand, cannot use the range slider.
Restoring the defaults
The Reset to Defaults button returns all static filters to their original state. Use it if you got "lost" in the settings and want to start over.
How filters appear in the store
Active filters are shown in the sidebar on category pages and in search results. How exactly the sidebar looks (static, closable, open by default) is set in Product Listing Configuration.
- The order of filters decides their order in the sidebar
- Closable / Starts Collapsed decides whether filters can be collapsed and whether they are collapsed on load
- Show More Limit hides long value lists under a button
Workflow
- Give your products attributes, parameters, labels and tags and brands
- In Filters, create filters from this data with Quick Create
- Optionally arrange the filters into filter groups
- Check the static filters (price, category, brand, tags, availability) and adjust their names and behaviour
- Set the filter order by dragging and check the result in the store