> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.linkedoption.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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](https://apps.shopify.com/search-and-discovery).
* 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**.

![Enable filter sources in Collection display](https://storage.crisp.chat/users/helpdesk/website/-/b/7/5/a/b75ae5b79c0f0000/01-enable-filter-sources_1jgj862.png)

*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**.

![Add a LinkedOption product metafield filter](https://storage.crisp.chat/users/helpdesk/website/-/b/7/5/a/b75ae5b79c0f0000/02-add-filter-source_4mpwh0.png)

*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**.

![Configure color and image filter values](https://storage.crisp.chat/users/helpdesk/website/-/b/7/5/a/b75ae5b79c0f0000/03-configure-filter-visuals_1tgjojc.png)

*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](https://help.shopify.com/en/manual/online-store/storefront-search/search-and-discovery-filters) and [displaying storefront filters in your theme](https://help.shopify.com/en/manual/online-store/themes/customizing-themes/common-customizations/storefront-filters).