Adding filters

You can use the Shopify Search & Discovery app to create filters for your online store that let customers refine which products are displayed on collection pages and in search results. For example, a store that sells watches could create filters for brand name, price, dial size, and water resistance.


Filters are available for any Online Store 2.0 theme, and custom storefronts that use either the filter Liquid API or Storefront API for their online store. Learn how to display filters in your Online Store 2.0 theme.

If your theme doesn't support filters, then you can still create filters in the Shopify Search & Discovery app, but they won't be displayed to customers.

You can determine whether your store's theme supports filtering by going to Online Store > Navigation in your Shopify admin. If your theme doesn't support filtering, then a message is displayed in the Collection and search filters section.

Considerations for adding filters

Review the following considerations for using the Shopify Search & Discovery app:

  • Collections that contain more than 5,000 products don't display filters. Consider dividing large collections into smaller collections that can display filters. For example, instead of creating a single Women fashion collection, you can create smaller collections based on the type of apparel, such as Tops, Jeans, and Boots.
  • A search that produces more than 100,000 results doesn't display filters.
  • A filter can display a maximum of 100 filter values on your store. If your filter has more than 100 possible values, then some values won't be displayed to customers. You can reduce the number of possible filter values by grouping similar values. A filter group can have a maximum of 200 unique filter values, and your store can have a maximum of 1,000 filter groups across all selected filter settings.
  • In the Shopify Search & Discovery app, a filter displays a maximum of 1,000 filter values. Metafield filters might display fewer than 1,000 values because there is a limit to how many metafields in the store are checked for unique values. Filter values not displayed in the app can still be displayed on your store to customers, provided the filter is displaying fewer than 100 filter values.
  • Translations aren't supported for the Vendor and Tags filter values. The product tag filter only displays to customers shopping in your store's default language. Vendor filter values are always based on your store's default language.
  • Filter value translations are based on the languages published for your online store, and won't display translations for markets set up with International.
  • The price filter doesn't display for currencies other than your shop's default currency.

Filter types

All stores can display the same standard filters and you can create custom filters unique to your product catalog. You can have a combination of standard and custom filters, up to a maximum of 25 filters for your store.

Each filter source can only be used one time for a store's filters. For example, if you have the Price filter active on your store, then Price is greyed out and can't be selected as the source for a new filter.

Standard filters

Standard filters for Availability, Category, Price, Product type, Tags, and Vendor are available to all stores.

Custom filters

Custom filters can be created using your product options, metafields, or metaobjects.

Product option filters are based on your product variants. For example, if you sell clothing with different variants for size, then you can add a product option Size filter.

Custom filters with metafields

Metafield filters are useful for creating filters unique to your product catalog. For example, if you sell children's toys, then you can create a custom Age product metafield filter. You can also create visual filters to help customers quickly understand your filters.

The metafields must have a metafield definition to be used as a filter. Learn how to add a metafield definition. You can create metafield filters for the following value types:

  • Single line text
  • Single line text (List)
  • Decimal
  • Integer
  • True or false
  • Metaobject reference
  • Metaobject reference (List)

After your metafields are set up on your products or variants, you can select the metafield definition as a filter when editing your filters.

Edit filters

  1. In the Shopify Search & Discovery app, go to Filters, and then click Add filter.
  2. Click the Source field, and then select a filter source that you want to make available to your customers.
  3. Optional: Rename the filter.
  4. Optional: Change the filter behavior.
  5. Optional: Select filter values to group together as a single value.
  6. Optional: Sort filter values.
  7. Click Save.

You can also reorder filters from the Filters section. Click and drag individual filters into the order that you want to display the filters to customers.

Rename filters

You can change the customer-facing name of any existing filter in your store.

Changing the filter name won't change information about the filter's source. For example, renaming a filter based on a product option won't change that option's name which is displayed on the individual product pages.


  1. In the Shopify Search & Discovery app, go to Filters, and then click the filter that you want to rename.
  2. In the Filter label field, enter your new label.
  3. Click Save.

Filter values

Only filter values that apply to products of a collection or search result display on your store.

There are different sorting rules applied to filter values, and you can use metafield filters for more control over sorting and displayed values.

Group filter values

You can group multiple filter values together to display as a single filter value to customers. For example, you have a product with a Color option that includes Onyx, Ebony, and Midnight. You can group these values together under a single filter named Black. A filter group can have a maximum of 200 unique filter values, and a store can have a maximum of 1,000 filter groups.


  1. In the Shopify Search & Discovery app, go to Filters, and then click Add filter or click the name of an existing filter.
  2. Optional: If you are adding a new filter, then click the Source field, and then select a filter source that you want to make available to your customers.
  3. In the Values section, select the values that you want to group as a single filter value. You can use the search bar to find more filter values.
  4. Click Create group.
  5. Enter a name for the group. This is the single filter value displayed to customers.
  6. Click Done.
  7. Click Save.


The Category filter does not support grouping.

Sorting filter values

You can sort filter values in a way that best suits your store's needs. We offer two sorting orders:

Automatic Sort

Filter values are displayed in ascending order by default, both alphabetically and numerically. For example, a product option filter of Shoe sizes will display the values from smallest to largest.

Filter values that start with a number and end with a word, such as 60 watts, will be displayed next to filter values that end with the same word. For example, a product option filter of Age with the filter values 2 years, 6 months, 3 years, and 2 months will be sorted in the following order:

  • 2 months
  • 6 months
  • 2 years
  • 3 years

Custom sort orders are applied for filters named Size, so that common sizing terms are displayed in the correct order. For example, XS (extra small) comes before S (small).

New filter values will be sorted automatically.

Manual sort

Manual sorting allows you to choose the display order of filter values. After saving a manual sort order, any new filter values are displayed at the end of the list until you update the sort order.


  1. In the Shopify Search & Discovery app, go to Filters and choose an existing filter or create a new filter.
  2. Under Sort, select Manually.
  3. Drag values to rearrange. Alternatively, you can select multiple values and click Move to top or Move to bottom to reposition them together.
  4. Optional: Click Reorder for me to sort with Shopify Magic
  5. Click Save.

Sort with Shopify Magic

You can use Shopify Magic to sort values in a logical order based on the filter name and its values. Filters using swatch filters consider the hex codes and their position on the color wheel to decide the sort order.

The Reorder for me button will sort your values with Shopify Magic. If the new order doesn't meet your expectations, then you can click the Undo reorder button to restore your manually sorted order, or re-arrange the values to better suit your store's requirements.


The Category filter does not support manual or magic sorting. Its values are sorted alphabetically.

Customize empty filter values

To help customers find available products, you can handle empty filter values by either moving them to the bottom of the list, or hiding them entirely. This allows customers to focus on values with matching results. For example, you sell T-shirts in different colors and sizes. All colors except Red are out of stock. If you move empty values to the bottom, then Red will display first in the Color filter. If you hide empty values, then only the Red option will be displayed in the Color filter.


  1. In the Shopify Search & Discovery app, go to Settings.
  2. In the Filters > Empty values section, select one of the following options:
    • To hide empty filter values, select Hide. A filter is hidden entirely if all filter values are empty.
    • To move empty filter values to the bottom of the value list, select Show at the end.
    • To keep empty filter values sorted by the default sorting logic, select Show in default order.
  3. Click Save.

Excluding filter values

If you need more control over the values that are displayed to customers, then you can use a metafield filter with only the values that you want to be displayed on your store.

For example, you might want to use product tags for purposes other than storefront filters, such as automated collection conditions or admin product list filtering. A metafield type of single line text or list type can be used instead of the product tag filter type.

Visual filters

Filter values can include visual elements such as colors, patterns, or more detailed imagery. For example, a Fabric color filter can display a small color swatch for each filter value.

To create visuals with your filter values, set up custom data for your store with metafields and metaobjects. You also need to meet the following requirements:

  • An Online Store theme that supports displaying filter value swatches and images.
  • A metaobject that meets the following criteria:
    • At least one color field or one file field with images. Both fields can only support one value, lists of values aren't supported.
    • A field to name the filter value. It must only allow one value, a list of values cannot be used as a filter name. The field can be any of the following types:
    • single line text
    • decimal
    • integer
    • boolean (true or false)
  • A metafield definition that meets the following criteria:
    • The definition is made for either a Product or Variant.
    • The metafield type is Metaobject and references the metaobject definition created in the previous step.
    • Set whether the metafields allow either one entry or a list of entries of the metaobject.
  • Both the metaobject and metafield definitions need to have storefront access activated.

Best practices for visual filters

Product variant filters will link to more relevant variants on search results and collection pages. For example, showing only red products when a red color swatch is clicked. Use variant metafields for the metaobject reference to use variant-level filtering. If linking to specific variants isn't important for your filter, then use product metafields instead.

A metaobject definition for a color swatch should have both a color and an image field. You don't need to provide a value for both, but this will give you the option of using either field in the future.

If your products or variants have multiple colors you could filter on, then set your metafield definition to allow a list of entries. This lets you assign multiple metaobject entries to a single item and each one will display as a filter value on your store.


After you have assigned your metafield to products or variants in your store, you can set up the filter for your online store:

  1. In the Shopify Search & Discovery app, go to Filters.
  2. Click Add filter or click an existing filter.
  3. Click the Source field, and then select a metafield filter with a metaobject reference.
  4. Click Display options.
  5. Set the Label field for filter values by selecting a metafield.
  6. Check Include visual and select a visual style:
    • Choose Swatch for small color swatches or patterns. Set the swatch content by selecting:
      • A color field for the Swatch color.
      • An image field for the Swatch pattern.
    • Choose Image for icons, logos, or other graphics that shouldn't be cropped. Set the content by selecting an image field for the Image.

Filter behavior

Only filters that can apply to the products on a collection page or search result are displayed.

Choosing filter values from different filters is an and condition that can decrease the number of products displayed. For example, choosing Red from a Color filter and 8 from a Size filter returns products that are both red and size 8.

By default, choosing filter values from the same filter is an or condition that can increase the number of results. For example, choosing Red and Green values from a Color filter returns all the products that are red or green. Certain filter types can use an and condition for their filter values instead. Learn how to customize filter behavior with the Shopify Search & Discovery app.

The number of products displayed also depends on whether the filters are product-level or variant-level filters. For example, a customer might choose multiple Color values from a product option filter, but only one product is displayed. This is because product options are variant-level filters and all the colors belonged to that single product's variants.

Customizing filter behavior

For product tag, metafield list and metaobject reference list filters, you can choose the filter condition between values to be either the default or condition or the and condition. For example, with and filtering, choosing New and Sale from a product tag filter only returns products that have both those tags.


  1. In the Shopify Search & Discovery app, go to Filters, and then click Add filter.
  2. Click the Source field, and then select a filter source that you want to make available to your customers.
  3. Choose the behavior to apply to the filter values inside the Logic section.
  4. Click Save.

Filter translations

Filter labels, values, and groups can be translated into your store's other supported languages. You can translate content with translation apps such as the Shopify Translate & Adapt.

When there isn't translated content for filters, the store's default language is used.

Filter values are based on the translated content for your products and product variants.

It's possible to have a different number of values for a filter between languages. For example, your store's default language is English, and you also add French as a supported language. Your Color filter values include the value Brown. English has one common word for brown, and French has two common words. Your translation app automatically translates the Brown filter value into either Brun or Marron across the store's products. Your storefront filters will display one value for brown in the Color filter in English, and two values for brown in French.

To keep only one translation for each filter value, you need to edit the product's translated content with a translation app.

Market languages

Filter value translations don't support additional instances of a language setup for specific markets. For example, an online store can have product translations for French and two additional French translations for the Canada and France markets. In this case, all the filter values are based on the general French language, even when customers are shopping in French for those specific markets.

Filter labels and filter groups support language translations for specific markets.

Can’t find the answers you’re looking for? We’re here to help.