↑↓ selectEnter openEsc close

    1. Elbuz

    How to set up the product filter in your store

    13 min readUpdated

    The store's product filter builds itself from attributes and options: tick “Bosch” and “7 kg”, see only what fits. In Elbuz you set its look and SEO pages for searches.

    When you need this:

    • Hundreds of products in a category — the filter appears where products have the attribute.
    • Size or power is chosen “from — to” — “Slider” builds a scale from numeric values.
    • An internal attribute clutters the filter — clear “Display in filter”; the export hides it.
    • A “Bosch washing machines” page for search — an SEO page: own address, heading, text.

    Where to start: “Store settings” → “Catalog” → “Product filter” card → “Filters” block.

    What the product filter can do

    Where filters come from

    Filters are the attributes and options of the store's products. After every catalog export from Elbuz, the store rebuilds the filter by itself, and the look you set on the screen stays. The export log gets the line “Store filter rebuilt: N criteria, M values”.

    What's in ElbuzWhat's in the store filter
    An attribute with the “Display in filter” checkbox in the “Attributes” window (in at least one category)The filter shows in every category that has products with this attribute
    An attribute without this checkboxThe filter exists but is hidden
    A new attribute with the checkboxThe type comes from the “Filter type” column in “Attributes”: checkbox, radio button or list; slider and range slider become “Slider”. After that, you set the type on the screen
    A product option, for example size or color with photosA filter with the option's values; you turn on its display on the screen. Value images exist only here
    The value “Black · White” (separated by “·”)Two values: “Black” and “White”
    “7 kg” in some products and “7kg” in othersTwo different values
    The attributes “Arrival date”, “Ingredients (INCI)”, “Actives”, “Who it suits”Don't become filters
    An attribute where most values contain “|” (ratings on a scale)Doesn't become a filter

    The filter name, values and categories come from product cards; you can't change them on the filter screen. To rename a filter or a value, fix the attribute in Elbuz and export the catalog. You can't add a filter by hand or delete one.

    How to tick “Display in filter” is covered in how to add an attribute filter to your storefront.

    How to change the look of a filter

    The “Filters” block is a table of all the store's filters, in the order customers see them. Under the name: where the filter comes from (attribute or option) and how many values it has.

    Filters block: table of filters with type, placement, order and switches
    1Rebuild filters
    2Type of the Size filter
    3Placement of the Colour filter
    4Order
    5Shown column
    6Values link
    1. Rebuild the filters from product attributes and options.
    2. How the customer chooses: checkboxes, radio buttons, a list or a slider.
    3. Whether the filter sits in the side panel or in a row above the products.
    4. The filter's position in the panel; a lower number is higher.
    5. A turned-off filter disappears from the site and its row turns grey; for Elbuz attributes visibility is set by Display in filter.
    6. The list of values of the filter.

    A change in a row goes to the store right away; there's no “Save” button here. If the store accepts it, you get the toast “Saved and applied in the store”. If not, the row value reverts and a red toast gives the reason: “The store did not accept the change: …”.

    ColumnWhat it setsOptions
    TypeHow the customer chooses“Checkboxes” — several values; “Radio buttons” — one; “Drop-down” — one from a drop-down list; “Slider” — a “from — to” range
    WhereThe filter's place on the page“Side” — in the panel; “Top” — in a row above the products
    OrderThe place among filters from attributes and optionsA whole number from −999 to 999; smaller goes higher
    “Shown” (eye)Whether customers see the filterFor options, you turn it on here. For attributes from Elbuz, the switch only shows the state: it's set by “Display in filter”, with the “Open “Attributes”” link next to it. A disabled filter is a grey row
    “Collapsed” (arrows)Only the filter heading showsThe customer expands it. Handy for secondary filters
    “Search” (magnifier)A search box above a long list of valuesThe global switch is “Search in values” in the “Appearance” block
    “Images” (picture)Images next to valuesWorks only for options with value images

    Slider for numbers

    The slider is built from the numbers in the values: 55, 7,5 or 7.5, 1 000, a range 50-80. It can't read values with units (“55 inches”), and the scale ends up with no products. Put the unit in the attribute name: “Screen size, inches”.

    If all products have the same number, there's no slider on the website. Switch the type back to “Checkboxes”, and the values and their products are still there.

    View a filter's values

    The “N values” link under the filter name opens the list of its values. To the right of each name is the Latin label of the value used in the page address when the filter is selected. The list is view-only: values come from the products.

    Values window of the Colour filter
    1Value name
    2Value code
    1. The value name taken from the product cards.
    2. The value code used in the address of the filtered page.

    Price, manufacturer, availability and other filters from product fields

    These filters don't come from attributes: the module calculates them from the product's own fields. Each has its own block on the screen with an “Enable” switch and “Order in the panel”. Changes in these blocks are saved by the “Save” button at the bottom of the window.

    On the website these filters come first in the panel, and “Order in the panel” (from 0 to 999) arranges them among themselves. Filters from attributes and options come after them.

    BlockWhat the customer seesWhat you can setDefault
    PriceA price slider“Logarithmic scale”, “Include tax”; which prices to use: “Base price”, “Quantity discounts”, “Special price”, “Option prices”On; base, quantity discounts and special
    ManufacturerA list of brands“Display type”, “Show logos”, “Show name”, “Placement”, “Show in categories”On, checkboxes, no logos
    DiscountThe “With discount” filter“Consider special prices”, “Consider quantity discounts”, “Placement”, “Show in categories”Off
    New arrivalsProducts added within a period“New for” and “Time unit” (hours, days, weeks, months), “Placement”, “Show in categories”Off, 30 days
    DimensionsWeight, length, width, heightEach separately: a switch and an orderOff
    Availability“In Stock” and “Out of Stock”“Detection method” — by quantity or by stock status; “Display type”; “Show "Out of stock"”Off, by quantity

    An empty “Show in categories” means the filter is in all categories. “Placement” is “Sidebar” or “Top (horizontal)”.

    These filters aren't part of SEO pages. A brand page is made through an attribute: which values you can pick.

    Where and how customers see the filter

    Product filter module screen with the General block
    1Block shortcuts
    2Category visibility
    3Apply button
    4Search settings
    1. Jump to the blocks: price, manufacturer, availability, appearance, SEO, filters, SEO pages.
    2. In which categories the filters are shown.
    3. Whether the customer's choice is applied by an Apply button or immediately.
    4. Quickly find a setting by its name.

    The “General” block

    FieldWhat it doesDefault
    Category visibility“As specified in filters” — the filter is where there are products with its attribute. “Show in parent categories” — a section shows the filters of all its subcategories. “Last level only” — no filter in a category with subcategoriesAs specified in filters
    Include subcategoriesValues also count products from subcategoriesYes
    Hide subcategoriesOnce the customer selects something, the subcategory list hidesNo
    In stock onlyThe filter counts and shows only products with a quantity above zeroNo
    Apply button“Yes” — the selection is applied by the “Apply” button; “No” — every click applies at onceYes

    The “Appearance” block

    FieldWhat it doesDefault
    Module titleThe filter panel heading, for each language—
    Button text, Button position, Panel position, Remember stateThe filter button on phones: its label; “Fixed”, “Static” or “Both”; panel on the left or right; whether to remember that the panel is openFixed, left
    Filters limitHow many filters show at once; the rest are under “Show more”. 0 — all12
    Load hidden filters on demandHidden filters load after “Show more”, so the page is lighterYes
    Hide single valueUntil the customer selects anything, a filter with one value isn't shownNo
    “From” and “to” fields by the slider, Marks under the slider“From — to” fields and a scale next to the sliderYes
    Selected filters blockSelected values above the filter, each removable with a crossYes
    Product counterThe number of products next to a valueYes
    Values limit, Load hidden values on demandHow many values show at once in the sidebar; the rest are under a button. 0 — all0, no
    Search in valuesAllows a search box in filters with “Search” onYes
    Hide emptyValues with no products also hide after other values are selected. Before the first selection, empty values never showNo
    Auto columnsValues in several columns, from 0 to 40

    Headings, meta tags and links

    This is the “SEO” block. The first three rows apply to a category page where the customer has selected something in the filter.

    FieldsWhat they doDefault
    Title modification, Modify H1, Add breadcrumb, SeparatorSelected values are added to the H1 heading and to the breadcrumbs: “Washing machines, Manufacturer Bosch”. “Separator” is the character between the name and the selectionYes, comma
    Auto meta tags, Modify titleThe selection is added to the page description for search engines, and with “Modify title” — to the tab title too. With “Auto meta tags” off, the page has its category's meta tagsYes
    Meta format, Values limit, LowercaseHow to write the selection: “Filter + value” (“Colour Red”) or “Value only” (“Red”); how many values to add; in lower caseFilter + value, 5
    Category links, Links positionA list of SEO pages in the category description: at the top, at the bottom or bothNo
    Module linksLinks to SEO pages in the filter panelNo
    Product linksLinks to SEO pages in product attributesNo
    Attribute linksAttribute values on the product page lead to the category with this filterNo
    Product breadcrumbsThe filtering path stays in the product breadcrumbsNo
    Generate sitemapA separate sitemap of SEO pages only. They're in the main sitemap even without itNo

    In link lists, SEO pages follow their “Order”; with equal values, by name.

    How to create an SEO page for a search query

    An SEO page is a category with filter values preselected, plus its own address, heading and text. A search for “bosch washing machines” lands straight on these products.

    1. In the “SEO pages” block, click “Add page”.
    2. On the “Page” tab, fill in “Address”, for example washing-machines/bosch. In “Category”, choose where the products come from; “All products” means no category.
    3. Click “Add value”: pick the filter in the first list and the value in the second. For several values — several rows.
    4. On the “Texts” tab, fill in “Name” in the store's main language. “H1 heading”, “Meta title”, “Meta description”, “Meta keywords” and “Description (HTML)” are optional.
    5. Click “Save”.
    SEO page window, Page tab
    1Texts tab
    2Address
    3Category
    4Filter value row
    5Add value
    6Do not index switch
    1. Name, H1, meta tags and description for each language.
    2. The page address, one for all languages.
    3. Where products come from; All products means no category.
    4. The page shows products that have this filter value.
    5. Add one more value of another filter.
    6. The page opens but is not indexed and stays out of the sitemap.

    The page appears in the block's table. Next to the block heading, a tag shows if the store accepted the list: “applied” or “not applied”.

    The app checks the page first, then the store. A store rejection doesn't undo the save in Elbuz
    noyesyesno, because of a field onthis pageno, another reason“Save” in the SEO page windowPage fields filled in correctly?Fields in red: “Not saved: fix thefields marked in red”The page is saved in Elbuz, thewhole list goes to the storeDid the store accept it?The window closes, a toast confirmsthe saveThe window stays open, the field ismarked, the list isn't appliedThe window closes, toast “Saved,but the store rejected it…”
    • Start or end
    • Action or result
    • Decision: the path depends on the answer

    Page address

    • One for all languages. Latin letters, digits, “-”, “_” and “/”. The app lowercases capitals and trims “/” at the ends. An empty address gives “Enter the page address”.
    • A duplicate of another SEO page's address isn't saved: “Another SEO page already has this address”.
    • An address taken by a product, category or website page, or a reserved word, is rejected by the store: “Another page of the website has this address”. The page stays in Elbuz, the window stays open, the field is marked.

    The store accepts the SEO page list only as a whole: while one page has an error, changes to the others don't reach the website. Fix the marked field and save again.

    Which values you can pick

    Only filters from attributes and options — the ones in the “Filters” block. Price, manufacturer, availability, discount, new arrivals and dimensions aren't part of an SEO page.

    Make a brand page through the “Brand” attribute: fill it in on product cards, tick “Display in filter” and export the catalog. Then you can pick “Brand: Bosch”.

    The store rejects a category that hasn't been exported (what to do).

    Display, noindex and texts

    FieldWhat it does
    Show the pageA disabled page doesn't open on the website. The record and the address stay
    Do not index (noindex)The page opens but isn't indexed and stays out of the sitemap. For ad or newsletter collections
    Show the filter blockFor a page without a category: the filter panel next to the products
    Show the selected valuesThe page's values shown over the filter; a cross removes each one. On an SEO page this switch overrides “Selected filters block” in “Appearance”
    OrderThe page's place in link lists on the website, in the block's table and in the sitemap; smaller goes higher
    StoresAppears only if the store has several storefronts

    Texts in another language need a “Name” in that language. Without it the page isn't saved: “Enter a name in this language — without it the store rejects the texts of the language”. A language with no texts gets the main language's texts.

    The browser tab title is “Meta title”, or “Name” if it's empty. The heading on the page is “H1 heading” or “Name”. A page with a category looks like that category with the values already selected and all its filters.

    Storefront page of a filter landing: breadcrumbs, heading, description, filter panel and product cards
    1Page heading
    2Description text
    3First product card
    1. The page's H1 heading; if it is empty, the page name is shown instead.
    2. The page's HTML description, shown under the heading.
    3. Products that have the selected filter value.

    The trash icon in a table row deletes the page from the store together with its address. Pages created earlier in the store itself are pulled into the table the first time you open the screen.

    How to rebuild filters without an export

    A catalog export rebuilds the filter by itself. The “Rebuild filters” button in the “Filters” block does the same without an export: it builds the filters again from the attributes and options already in the store. You need it if the export log has the line “Store filter not rebuilt: …”.

    • After you confirm, the toast “Rebuilding filters…” stays on, then “Filters rebuilt: N criteria, M values” appears. That's how many there are now in total.
    • Until it finishes, customers see the old filter; the new one appears all at once. If it fails midway, the old one stays.
    • The look is kept: type, “Where”, order, display, collapsed, search and images — for filters from the same attribute or option. New filters arrive as checkboxes and are shown right away.
    • The button doesn't re-read the “Display in filter” checkbox: a change in “Attributes” arrives with the export.
    • An attribute value no product has any more disappears from the filter and from SEO pages. The pages' other values stay.
    • On a large catalog, a rebuild takes up to a few minutes. A second run waits for the first to finish.

    After a big catalog update, look through the “SEO pages” table: a value that's gone shows in Latin in the “Filter values” column. In the page window it's marked “… — no longer in the filter”, and you can't save the page until you remove that row with the cross.

    Scenarios

    TVs: screen size as a slider

    In the “Screen size, inches” attribute, enter numbers only: 43, 55, 65; choose slider in the “Filter type” column in “Attributes” and export the catalog. The filter now exists — choose “Slider” in its row. A customer picks a TV from 50 to 65 inches in one move.

    Bosch washing machines in search

    Add a page: “Address” — washing-machines/bosch, “Category” — “Washing machines”, value — “Brand: Bosch”. “Name” — “Bosch washing machines”, “Meta title” — “Bosch washing machines — prices, delivery”, and in “Description (HTML)” — how to choose one. Do the same for Samsung and LG.

    Clothing: only what's in stock

    In the “General” block, turn on “In stock only”; in “Appearance”, turn on “Hide empty”. In the “Availability” block, set “Enable” so customers can filter for “In Stock” themselves. Save.

    Internal attributes out of the panel

    “Warranty” or “Supplier code” aren't needed in the filter. Clear their “Display in filter” in “Attributes” and export the catalog — the filters hide. Give the main filters an “Order” of 1–3, and set the secondary ones to “Collapsed”.

    A newsletter collection without search

    An SEO page “Cordless tools” with “Power source: Battery” and the “Do not index (noindex)” switch on. The link works in the newsletter, and the page doesn't compete with the category in search.

    What to do when the filter doesn't work as expected

    What you seeWhyWhat to do
    “No filters yet. Export products with attributes or options and click “Rebuild filters”.” The store's products have no attributes or options, or the filters haven't been built yet Fill in attributes on product cards and export the catalog
    The filter isn't in a category “Display in filter” isn't ticked or “Shown” is off; the category's products don't have the attribute; “Category visibility” is “Last level only”; the filter is beyond the “Filters limit” Check “Attributes”, the row in the “Filters” block and the “General” block. A filter beyond the limit is under “Show more”, or raise its “Order”
    The export log has “Store filter not rebuilt: …” The store didn't respond or couldn't rebuild the filter. The products were exported, the filter stayed old Click “Rebuild filters” on the “Product filter” screen. Display by “Display in filter” is updated by the next export
    A slider with no products The values aren't numbers, for example “55 inches” Keep only numbers in the values and the unit in the attribute name, then export the catalog
    “The store did not accept the change: The store no longer has this filter — reload the window” The filter disappeared after a rebuild: products no longer have its attribute Close and reopen the filter screen — the table is re-read from the store
    “Another page of the website has this address” Something else on the website — a product, category or page — already uses this address, or it's a reserved word Use a different address, for example washing-machines/bosch-slim, and save
    “This is not on the website yet — export the catalog first” The selected category isn't in the store yet Export the catalog or choose a different category
    The SEO page window has the row “… — no longer in the filter”, and the page won't save The value disappeared from the filter: no product has it any more Remove the row with the cross or choose another value, then save
    An SEO page opens with no products No product matches all the selected values, or a value disappeared after a rebuild Check the page's “Filter values”. If there are no products, turn off “Show the page”
    “The module update comes with the next store release — after it you can manage filters here.” The store has an old version of the filter Nothing: after the store update, the “Filters” and “SEO pages” blocks start working.

    FAQ

    I changed an attribute on a product — why does the filter show the old value?

    The filter is updated with the catalog export. Export the catalog, or click “Rebuild filters” if the products are already in the store.

    Why can't I click the “Shown” switch in a row?

    It's a filter from an Elbuz attribute. Its display is set by the “Display in filter” checkbox in “Attributes”: the “Open “Attributes”” link is right next to it.

    A value shows 0 and can't be selected. Why?

    Given what's already selected, there are no products with this value. To hide such values, turn on “Hide empty” in the “Appearance” block.

    I selected a value and nothing changed. Why?

    “Apply button” is on: click “Apply”. Or turn the field off in the “General” block — then every click applies at once.

    Do SEO pages survive an export and a rebuild?

    Yes, together with their values. Only a value no product has any more disappears.

    Where to find it and who has access

    Menu
    Directories → Operations → Store settings → “Catalog” → “Product filter”
    Other entry points
    the “Attributes” window — the “Display in filter” checkbox and “Filter type”
    Access rights
    the “Store settings” window in group permissions
    Prepare
    attributes on product cards, a catalog exported to the store

    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