↑↓ selectEnter openEsc close

    1. Elbuz

    How to add an attribute filter to your storefront

    8 min readUpdated

    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

    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).

    1. Select a category in the tree of the “Attributes” window.
    2. Find the attribute with the “Search attribute…” field.
    3. 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:

    1. Looks for attributes that have non-empty values without an ID.
    2. If there are none, it only removes from the list of possible values those that no product has; the toast is the same, “Updated”.
    3. 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.
    4. 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.

    Left branch: all values already have IDs, and the item only removes extras. Right branch: recalculation in batches of 100 attributes until no batches are left
    noyesyesnoyesnorequest failed“Maintenance” → “Cleanup” →“Update attribute value IDs (filters)”Blue “Processing data, please wait”toast for 200 secondsAre there attributes with non-emptyvalueswithout an ID?Values that no product has areremovedfrom the list of possible valuesAttributes are taken in batches of100For the batch, the value list iscleared,IDs in products are recalculatedIs “Split attribute values” on?Values with a delimiter are split intoseparate onesAny batches left?“Updated” toastRed toast with the error text
    • 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

    Common problems
    What you seeWhyWhat 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

    Was this article helpful?

    Missing a feature? Tell us.

    We will add it for free if other users need it too.

    If only you need it, we will agree on it separately.

    Article contents

    Suggest an improvement

    Try Elbuz free