In Elbuz, one checkbox in a category makes a product attribute a filter in your store catalog: shoppers narrow products by screen size, color or memory, while a neighboring category can leave it out.
When you need this:
- Filter graphics cards by GPU manufacturer — check “Display in filter” in the “Graphics cards” category.
- Laptops don't need that filter — leave the checkbox off there.
- Screen size as a “from–to” slider — the “Filter type” column sets the control.
- Checkbox on, filter missing — one menu item recalculates internal value IDs.
Where to start: select a category in the “Attributes” window tree and check “Display in filter”.
What the attribute filter can do
- Show an attribute in a category filter — separately in each category.
- Choose how the filter looks — checkbox, radio button, list, slider, range slider.
- Fix a filter that doesn't appear on the storefront — recalculate value IDs.
- Let AI choose the filters — the model marks attributes for filters on its own.
How to show an attribute in a category filter
The “Display in filter” checkbox decides whether an attribute becomes a filter in your store catalog. It is set separately in each category: “GPU manufacturer” can filter graphics cards but not laptops (what an attribute has per category).
- Select a category in the tree of the “Attributes” window.
- Find the attribute with the “Search attribute…” field.
- Double-click to check “Display in filter”.
For many categories at once, use the “Categories” button, “Display in filter” column (the “Categories” button).
Next to it, the “Filter (select products by attributes)” column group has six more:
- “Filter type” — which control shows the attribute in the filter: checkbox, radio button, list, slider, range slider.
- “Value suffix” — what is added after the number: “cm”, “GB”, “W”.
- “Max. number of attributes” and “Max. number of values” — limit list length; set in each category, or shared at the tree root (editing in the grid).
- “Value list expanded” — the filter is shown expanded rather than collapsed.
- “Display horizontally” — values line up in a row instead of a column.
What to do if the checkbox is on but the filter is missing
Checkbox on, but no filter on the storefront. Usually the values lack the internal ID the filter works by — typical for values from old imports. Fix: “Maintenance” → “Cleanup” → “Update attribute value IDs (filters)”. While it runs, a blue “Processing data, please wait” toast shows; at the end — “Updated”.
What this item does, step by step:
- Looks for attributes that have non-empty values without an ID.
- If there are none, it only removes from the list of possible values those that no product has; the toast is the same, “Updated”.
- If there are some, it takes them in batches of 100 attributes, and for each batch clears the value list, resets the IDs in products and recalculates everything.
- If “Split attribute values” is turned on in system settings, values with a delimiter are split into separate ones right away.
How long it takes and whether you can close the window. The operation doesn't go to the background job queue: it runs within a single request while the open page waits for it. There is no limit on the number of products or values.
The blue “Processing data, please wait” toast stays up to 200 seconds; if the work takes longer, it disappears on its own while the server is still calculating. Wait for the “Updated” toast. If the request fails, a red toast with the error text appears.
If the work was interrupted. Batches that finished stay done. In the batch where it broke off, values may be left without IDs — the very state this item fixes. Running it again fixes that: the program finds the attributes with missing IDs again and recalculates only those, leaving the finished ones alone.
The same recalculation runs automatically at the end of a import or site tunnel that loads attributes — for the whole catalog: the value list is cleared and rebuilt. If the import breaks off here, the whole catalog's values lose IDs; the same item fixes it.
- Action or result
- Decision: the path depends on the answer
Scenarios
You need an attribute filter in one category but not in the neighboring one
What to do. Select the category in the tree where you need the filter, and check “Display in filter” in the attribute row. In the category where you don't need the filter, leave it unchecked.
What happens. The filter setting is saved only on the link between the attribute and this category — as in the “GPU manufacturer” example, which filters graphics cards but not laptops. If the checkbox is on but the filter is missing on the storefront, run “Maintenance” → “Cleanup” → “Update attribute value IDs (filters)”.
What won't happen. Other categories won't see this change. But if you check the box while the tree root is selected, it's saved to the shared “all categories” record — as the default value, not as the setting of the category you need.
A YML import broke off and filters on the site stopped working
What to do. Run “Maintenance” → “Cleanup” → “Update attribute value IDs (filters)” and wait for the “Updated” toast.
What happens. The program finds values without IDs and recalculates them in batches of 100 attributes.
What won't happen. Attributes whose values all have IDs already aren't recalculated. An attribute missing even one ID is recalculated in full.
What to do when the filter doesn't appear on the storefront
| What you see | Why | What to do |
|---|---|---|
| “Display in filter” is on, but the filter is missing on the storefront | The attribute values have no internal ID calculated, and the filter works by that ID | “Maintenance” → “Cleanup” → “Update attribute value IDs (filters)” (storefront filter) |
FAQ
Why the “Display in filter” checkbox if the attribute is already on the card?
The product card and the storefront filter are different things. “Show in product (category) card” controls the field in the product, “Display in filter” controls how shoppers narrow products on the site. Both are set separately in each category.
Can new attributes become filters automatically?
No: for new attributes the checkbox is off. Turn it on manually in the categories you need, or let AI do it — “AI tools” → “Pick attributes for filters” (AI and attributes).
I checked the box at the tree root — why is there no filter in the category?
At the root, the checkbox is saved to the shared “all categories” record — that's the default value, not a category setting. Select the category you need and check the box there.
Why doesn't the filter show all values?
List length is limited by “Max. number of values” — set per category or shared from the tree root. Check the number in the attribute row with the category selected (filter columns).
Can I close the page while value IDs are updating?
Better wait for the “Updated” toast: the operation runs within a single request. If the work was interrupted, run the item again — it only calculates what's missing (how it works).
Where to find it and who has access
- Menu
- Directories → Base product catalog → Attributes → “Display in filter” column
- Many categories at once
- “Categories” button → “Display in filter” column
- ID recalculation
- in the “Attributes” window: “Maintenance” → “Cleanup” → “Update attribute value IDs (filters)”
- Access right
- the “Attributes” window in group permissions
- Prepare
- an attribute enabled in the category, and values in products
The filter works only for an attribute that is already enabled in the category. To enable it, see How to add an attribute to the product card.
Related topics
- For the big picture — what an attribute shares and what it has per category: How to add an attribute to the product card.
- If the attribute you need isn't in the directory yet: How to create, edit and delete an attribute.
- If one value is written three different ways in the filter: How to clean up attribute values.
