Skip to main content

Filter option settings

Configure the filter options inside a filter tree, including display, values, and advanced behavior.

Written by Thomas Ta

Every filter tree can hold multiple filter options, and each option can be styled, ordered, and configured on its own. The values inside a filter option are pulled automatically from the products in the collection being displayed.


What is a filter option?

A filter option is a selectable filter tied to a specific product attribute or metafield. It gives shoppers a set of choices to narrow products, and choosing the right options and layout for a collection can improve the browsing experience and reduce bounce rate.

Each filter tree supports up to 30 filter options, and each filter option can hold up to 1,500 filter values.

💪 For example, a sweater collection might use filter options like size, material, price, and color. Within the color option, shoppers could choose values like red, green, and blue.


Open filter options for a filter tree

  1. From app admin, go to Discovery > Filter settings.

  2. In the Action column for the filter tree you want, click the editing icon.

  3. To create a new option, click + Add filter option. To edit an existing one, click the editing icon next to it.

Either action opens a settings popup where you can configure the option. Each filter option combines General and Advanced settings.

💡 When you add or edit a filter option, a live preview appears on the right side of the screen and updates as you adjust settings. Use the device toggle to preview desktop or mobile.


General settings

Depending on the option type, you will see general settings like:

  • Option label: the name shown to shoppers on the storefront.

  • Option display: how values appear, such as same-level or multi-level collections, a list, boxes, swatches, or a range slider.

  • Option select: whether shoppers can pick one value or several at once.

  • Filter values: show every value automatically, or manually choose which ones appear.

To reorder values manually:

  1. Set Filter values to manual specific values.

  2. Under Manual values, select the values you want to include.

  3. Drag them into the order you want.

  4. In Advanced settings, turn off Sort manual value so your custom order is not overridden, then save.

  5. Save again on the Filter options page.

⚠️ Note: Keep the filter option unchanged (collection filter option) controls what happens when a shopper picks a collection from this filter. Leave it off and collections that do not match the current page's criteria are hidden. Turn it on and every collection stays visible regardless of context. Selecting a collection always takes the shopper to that collection's page.


Advanced settings

  • Display tooltip: add a short explanation next to a filter option when its meaning is not obvious to shoppers.

  • Uppercase display: force all filter values to render in uppercase.

  • Sort manual value: when using manual ordering, choose whether values still sort alphabetically or by product count.

  • Sort type (alphabetical / product count): automatically order values one of these two ways.

  • Show more style: choose how long lists behave, such as a scrollable box, showing everything at once, a "view more" link, or "view more" with scrolling.

  • AND condition: available for tag and multi-level tag filters. When on, only products matching every selected tag appear, rather than any one of them.

  • Collapse on desktop / mobile: decide whether the filter option is expanded by default or hidden until a shopper clicks to open it.

  • Search box on desktop / mobile: for vertical filter options, adds a search field so shoppers can find a specific value within that filter. Not available for multi-level tag filters, or for collection filters using the multi-level collections display.

  • Display "All" collection (collection filter option): adds an option letting shoppers view products across every collection at once.

  • Excluded values: for collection, product type, location, vendor, tag, and metafield options, hide specific values so shoppers can filter more precisely.

  • Prefix: appears specifically for tag-based filters.

After editing or adding a filter option, click Save to save all option settings.


Turn a filter option on or off, or delete it

  • Turn a filter option on or off with the toggle in its Status column.

  • Click the trash icon to delete an existing filter option.

⚠️ Note: Click Save settings to save all filter option settings for a filter tree.


Feel free to reach out to our dedicated support team via chat with any further questions.

Did this answer your question?