Merge filter option values into a group

Merge near-duplicate filter option values (e.g. Light Blue, Dark Blue, Midnight Blue) into a single group shoppers see as one value.

What this does

Combines several near-duplicate values into a single value shoppers see and click on — for example, merging Light Blue, Dark Blue, and Midnight Blue into one group called Blue, so a shopper filtering by color sees one clean "Blue" option instead of three overlapping shades. This is useful whenever your product data uses more specific or inconsistent variant/tag values than you want shoppers to actually filter by.

Steps

1. In the app, go to Settings > Group values (under Catalog in the Settings menu) — or click Group values on the Filters page, which opens the same page.

2. Click Add group.

3. Enter a Group name — this is what shoppers will see (e.g. "Blue").

4. Choose the Source — the filter data type this group applies to.

5. Under Values, choose the specific values to merge into this group.

6. Click Save.

Add group — Group name, Source, and Values fields

Once saved, go to the Home dashboard and click Sync now — merged groups don't take effect on the storefront until the next sync.

If the group doesn't show up on the storefront

The new group normally appears in the filter sidebar right after syncing. If it doesn't:

1. Go to Filters, open the filter option's sidebar, and open the option under Filter Options.

2. Click Edit.

3. Under Values, set Type to Manual selection.

4. Add the group to the Selected Values column, then click Save.

Remove the original values after merging

Merging doesn't remove the original values from the filter option — they'll still show up on their own unless you remove them:

1. Go to Filters, open the filter option's sidebar, and open the option under Filter Options.

2. Click Edit.

3. Under Values, set Type to Manual selection.

4. Remove the individual values you just merged from Selected Values, then click Save.

Bulk import/export groups via CSV

For a large number of groups, use Import / Export on the Settings > Group values page instead of creating each one manually.

Related pages

• Configure filter options

• Manage filter option values