Product Filters

Filters let customers narrow down the product list on your storefront by the parameters that matter to them — for example by color, size, brand, price or availability. They appear in the sidebar on category pages and in search results.

Path: Admin > Products > Filters

The filter system has three parts:

• Filters — custom filters you build from your products' attributes, labels and tags
• 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 build them on top of data you already have on your products — attributes, labels and tags, brands, categories and price. So set up your product attributes first, then create filters from them.

Filters

Path: Admin > Products > Filters

This page shows the list of all created filters, and at the top a Quick Create Filters tool that builds filters from your existing attributes, labels and tags.

Filter list

You can search and organize filters using the tools above the table:

• Search — by filter name or field
• Type — restrict to a specific source type (attribute, price, category, tag, label)
• Group — restrict to filters in a specific group
• Sorting — by name or display order

You can change the order of filters by drag-and-drop — this determines the order in which filters appear to the customer.

Creating a filter (Quick Create)

Path: Admin > Products > Filters > Add filter

You create a filter by picking the source it should be built from. Sources are grouped into three categories:

• Attributes — for example Color, Size, Material. Each attribute shows the number of available values
• Labels — individual labels (new, sale, etc.), or the All Labels option, which creates a single filter from all labels
• Tags — individual tags, or the All Tags option for a single combined filter

After you click a source, a dialog with settings opens:

Setting	Description
Display name	The filter name the customer sees. Entered per language (language tabs). If left empty, the source name is used
Display type	How the filter is rendered (see table below)
"Show more" limit	How many values are shown before the rest are hidden behind a "Show more" button. Default is 5
Closable (collapsed)	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	Checkable values, several can be selected at once. The most commonly used type
Checkbox	Classic checkboxes
Dropdown	Selection from a dropdown list
Range slider	A from–to slider. Available only for price and numeric attributes (attributes whose values are all numbers)

Range slider

The range slider can only be used for price or for an attribute whose values are all numeric (e.g. "Memory size" with values 128, 256, 512). If the source is not numeric, the system will not allow this option to be saved.

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 hidden on the storefront but stays saved
• Delete — permanently remove the filter

Bulk collapse settings

Above the filter list there is a bulk action that sets all filters as closable/non-closable and optionally starts-collapsed in one step. You can optionally include static filters as well. This is handy when you want to unify how all filters behave on the storefront.

Filter groups

Path: Admin > Products > Filter groups

Groups let you neatly organize related filters (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	Group name (multilingual)
Description	Optional group description (multilingual)
Icon	Optional group icon
Color	Optional group color (format #RRGGBB)
Order	Display order of the group
Active	Whether the group is active

WARNING

A group that contains filters cannot be deleted. Move the filters to another group or remove them from the group first.

Static filters

Path: Admin > Products > Static filters

Static filters are always-available system filters that you do not build from attributes — they are part of the system. They include:

• Category
• Price
• Brand
• Tags
• Availability (stock status)

For each static filter you can edit:

Setting	Description
Display name	The name the customer sees (multilingual)
Display type	Dropdown, multi-select, checkbox, radio, 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 appears on the storefront
Order	Display order 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.

Reset to defaults

The Reset to defaults button returns all static filters to their original state. Use it if you have "lost your way" in the settings and want to start over.

How filters appear on the storefront

Active filters appear in the sidebar on category pages and in search results. Exactly how the sidebar looks (static, closable, open by default) is configured in Product List Configuration.

• The filter order determines their order in the panel
• Closable / Starts collapsed determines whether filters can be collapsed and whether they start collapsed
• The "Show more" limit hides long value lists behind a button

Workflow

1. Set up product attributes, labels and tags and brands
2. In Filters, build filters from this data using Quick Create
3. Optionally organize your filters into filter groups
4. Review the static filters (price, category, brand, tags, availability) and adjust their names and behavior
5. Set the filter order by dragging and verify the result on the storefront

More information

• Attributes
• Labels, Brands & Tags
• Units & Sorting