Add product group options to Shopify Search & Discovery filters

Use product group options such as Color and Size as storefront filters on collection pages and search result pages.

Setup has two parts: first create the filter sources in Collection display, then add those sources in Shopify Search & Discovery.

Before you start

• Install the free Shopify Search & Discovery app.
• Make sure your theme supports storefront filtering. Filters can be created in Search & Discovery even when a theme cannot display them.

1. Create the filter sources

1. Go to Settings > Collection display.
2. Enable Make product group options available as filters.
3. Save your changes.
4. Wait until Current status shows Up to date.

1 — Create filter sources. 2 — Optional: let filters match any product in a group.

A separate source is created for each product group option name. For example:

• LinkedOption Filter: Color
• LinkedOption Filter: Size
• LinkedOption Filter: Style

2. Add a filter in Shopify Search & Discovery

1. From Shopify admin, go to Apps > Search & Discovery.
2. Click Filters.
3. Click Add filter.
4. Click Source.
5. Search for LinkedOption Filter:.
6. Select the product metafield for the option you want, such as LinkedOption Filter: Color.
7. In Filter label, enter the name shoppers should see, such as Color.
8. Keep OR condition for most stores. This shows products that match any selected value.
9. Click Save.

1 — Click Add filter. 2 — Choose the LinkedOption Filter product metafield you need.

Repeat these steps for each option you want shoppers to filter by.

3. Show color or image swatches

Skip this section if you want a text-only filter.

1. Open the filter in Shopify Search & Discovery.
2. Click Manage values.
3. Set Label to Label (display name).
4. Enable Include visual.
5. Select Swatch.
6. Set Swatch color to Color.
7. Enable Use images when available.
8. Set Swatch pattern to Image.
9. Click Done, then click Save.

1 — Label. 2 — Swatch. 3 — Color. 4 — Use images when available. 5 — Image.

Single-color values use the color field. Two-color and image swatches use the image field when available. Keep the visual style set to Swatch so Shopify can use both fields.

4. Display filters in your theme

Shopify themes control whether filters are visible to shoppers.

1. From Shopify admin, go to Online Store > Themes.
2. Click Customize on your current theme.
3. Open a collection page template.
4. Select the Product grid section.
5. Enable filtering, then click Save.

To show filters on search result pages, open the search template and enable filtering in the Search results section. The exact setting name can vary by theme.

Find products from the whole group

Use Let filters find every product in the group only when Show only the main product from each group is also enabled.

Example: Red is the group's main product and Blue is another product in the same group. When a shopper filters by Blue, the Red main product remains in the results. The product card does not automatically switch to Blue.

Check your filters

Open a collection page and try the filter. Shopify only displays filter values that match products in the current collection or search results.

Filter values are synced in the background and can take a few minutes:

• Updating means recent product group changes are being synced.
• Up to date means the latest filter values are ready.
• Needs attention means the sync could not finish. Use Retry sync.

If filter values look outdated, use Refresh on the app home page to run a full check.

Learn more about adding filters with Shopify Search & Discovery and displaying storefront filters in your theme.

Updated on: 19/08/2026