For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configure filter options

A filter option is one filterable attribute — Price, Size, Color, Availability, Vendor, a product tag, or a metafield. Each option shows a list of values shoppers can select (for a Color option, the values would be Red, Blue, Green, and so on).

Starting set of options

When you open a filter (see Configure filter sidebar), its Filter options table already lists every available source for your store — built-in properties (Collection, Category, Vendor, Product Type, Price, Percent Sale, Availability, Tag, Ready to ship, Location) plus one row per variant option your products use (Color, Size, Material, and so on).

Add a filter option

Pls follow these steps below:

  1. Open the filter and click Add filter option.

  2. Choose the Source for this option.

  3. Set a Label (what shoppers see) and a Display type.

  4. Click Save in the bar at the top of the page.

Edit a filter option

Click a row's Edit action to open Edit filter option, where you can change:

  • Source and Label (the label also sets the URL query parameter shoppers see, e.g. ?color=Blue — use Edit URL handle to change just the parameter name).

  • Display type: Checkbox, Radio, Range slider, Swatch, Swatch - Text, Box - Rectangle, or Select. See Color swatch for filter option for the two swatch types.

  • Values — which values show and their sort order; see Manage filter option values.

  • Display options and Advanced settings — collapse behavior, AND/OR matching, text casing, and more; see Manage filter option values and Use AND filtering condition.

Edit filter option — Source, Label, Display type

Which display types are available

The Display type dropdown only shows options that make sense for that option's data:

  • Text/category attributes (Color, Material, Tag, Vendor, and similar) — full choice of Checkbox, Radio, Swatch, Swatch - Text, Box - Rectangle, or Select.

    Color option — Display type dropdown
  • Numeric/range attributes (Price, Percent Sale) — locked to Range slider, with a Slider step field instead of a value list.

    Price option — Range slider only
  • Yes/No attributes (Ready to ship, and similar) — locked to a Yes/No display, with no value list or Logic setting.

Because of this, a numeric or Yes/No option's Edit page also skips sections that don't apply to it (no Values > Type/Sort, no Logic OR/AND, no Enable search within values) — that's expected, not a bug.

Reorder filter options

Drag a row by its handle in the Filter options table to change the order options appear in on the storefront.

Remove a filter option

Click Remove on the row, then Save. This removes it from the storefront immediately; it does not affect your Shopify product data.

Last updated

Was this helpful?