How to Add Shopify Collection Filters

Shopify collection filters come from the Search & Discovery app, and they show only when the theme supports them. A collection with more than 5,000 products does not display filters. The price filter does not show for a currency other than the shop default.

By Charles · Published · Updated

Illustration of a laptop on a wooden desk showing a clothing grid with color dots and blank filter rows.

Collection filters on Shopify are created in the Search & Discovery app. Customers see them on a collection or search page only when the theme can display filters, and only for values that apply to the products on that page.

Filters sit on the collection template, so the layout they share is covered in the guide to Shopify template changes. If the theme cannot show the filters you need, send a project brief before changing theme code.

Key facts

  • Filters are available for a compatible theme, or a custom storefront using the filter Liquid API or Storefront API. An unsupported theme can still store filters in the app, but customers will not see them. Shopify Help Center, checked 10 November 2026.
  • A collection with more than 5,000 products does not display filters. Shopify suggests splitting a collection that large. Shopify Help Center, checked 10 November 2026.
  • A store can have up to 25 filters, and each filter source can be used once. Shopify Help Center, checked 10 November 2026.
  • The price filter does not display for a currency other than the shop default. Shopify Help Center, checked 10 November 2026.

How do you add a collection filter?

Open the Search & Discovery app, add a filter from a source the store already has, and save. Shopify's steps are: Apps, then Search & Discovery, then Filters, then Add filter. Choose a source, and optionally rename it, change its behavior or visual display, group values, or sort them. Save. You can drag filters into the order customers should see.

To see whether the current theme can show those filters, go to Content, then Menus. Shopify says a message appears in the Collection and search filters section when the theme does not support filtering.

Only values that apply to the products in that collection, or to that search result, are shown. An empty color does not appear just because it exists on another collection.

Which filter sources can you use?

Standard filters are Availability, Category, Price, Product type, Tags, and Vendor. Custom filters come from product options, metafields, or metaobjects already used in the catalog. A source that is already active cannot be selected again. If Price is on, Price is grayed out for a second filter.

Source What it uses Extra constraint from the help page
Standard Availability, Category, Price, Product type, Tags, Vendor Price is hidden when the customer is not using the shop default currency. Translations are not supported for Vendor and Tags filter values.
Product option Option names such as Size, taken from the products Option names need to match across products. Shopify's example is using Color everywhere, not Color on some products and Color: on others.
Metafield A metafield definition on products or variants Supported types listed on the help page are single line text, a list of single line text, decimal, integer, true or false, and a metaobject reference or list of those references.

For how a metafield is stored and shown on a product page, see Shopify product metafields. A filter uses the definition as a source. It does not replace the product-page display.

Product metafield filters are based on metafields assigned across products. Category metafield filters are based on metafields assigned to specific product categories. Variant metafield filters use variant metafields. Shopify also says that if you migrated product options to category metafields, remove the old product-option filters and add category metafield filters instead.

Why might a filter stay hidden?

Start with the theme check under Content, then Menus. If the theme does not support filters, the app can store them and the storefront still will not show them.

Then check the size of the collection. Shopify says filters are hidden when a collection contains more than 5,000 products. The troubleshooting section also says filters are hidden when a search returns more than 100,000 products. The considerations section says filter value counts on search are based on up to the first 1,000 results. Those are separate statements on the same page. If a search filter looks incomplete, use that page rather than treating one number as the only cap.

The considerations section says a filter can display a maximum of 100 values. The troubleshooting section says tags can have up to 5,000 unique values, and product options and attributes up to 1,000. The page does not collapse those into one rule. If values are missing, compare the filter type with both sections.

Shopify also says a missing or stale filter can follow a recent metafield or product change, and that search indexing can take 24 to 48 hours. The documented manual nudge is a small product save, such as adding a space to the title. Contact Shopify Support if it is still wrong after that. Do not treat a title edit as a filter setting.

Empty values have their own control. In the app, open Settings, then Filters, then Empty values. Hide removes empty values, and hides the whole filter when every value is empty. Show at the end moves empty values to the bottom. Show in default order keeps the normal sort.

How do selected filters combine?

Values chosen from different filters are an and condition. Shopify's example is Red from Color and 8 from Size: the customer sees products that are both. Values inside one filter are an or condition by default. Red and Green from Color returns products that are red or green.

Product tag, metafield list, and metaobject reference list filters can be switched to an and condition in the Logic section. With and, New and Sale on a tag filter returns only products that have both tags.

A product-option filter is variant-level. Shopify notes that several color values can still return one product when those colors are variants of that product.

Visual swatches need a metaobject reference filter and a theme that supports the filter value API. The help page lists the field rules for a custom swatch. If the theme cannot show swatches, the text filter can still be the right stop.

When would a theme change be separate work?

Filter setup in Search & Discovery is an admin task. It is not, by itself, a new theme section. If the theme cannot display filters, or the collection grid needs a section the theme does not have, that is different work.

Ecommerce Nerds publishes a Custom Section package at $699 USD for one new theme section. A collection page feature is one of the listed examples. A Quick Fix is $299 USD for one bug or small change, with examples that include a Liquid or CSS fix and an app and theme conflict. The brief is where that fit gets confirmed. The published promise is a fixed quote within 1 business day. Read the custom sections guide before asking for a new section, and the services page for the section package.

Frequently asked questions

Why are my Shopify collection filters not showing?

Check that the theme supports filters. Shopify says a message appears under Content, then Menus, in the Collection and search filters section when it does not. Filters also stay hidden on a collection with more than 5,000 products.

How many filters can I add in Shopify?

Shopify says you can have up to 25 filters, and each filter source can be used only once.

Does the Shopify price filter work in other currencies?

No. Shopify says the price filter does not display for currencies other than your shop default currency.

Can I filter a Shopify collection by a product metafield?

Yes, when the metafield uses a supported type and is set up on your products or variants. You then choose that metafield definition as a filter in Search & Discovery.

If the storefront still does not match the filters you saved, send a project brief with the theme name, the collection URL, and what you expected to see.