Help CenterContact support
All Custos: EU Compliance articles

How do I let shoppers filter collections by allergen-free?

Updated

On this page
  1. Before you start
  2. Add the filter in Search & Discovery
  3. What the values mean
  4. Troubleshooting

The app can give each product with a published label a yes/no value per allergen group, such as “Without milk (per EU label)”. Shoppers only see these values as a collection filter after you add the filter in Shopify’s Search & Discovery app. Apps can’t add Search & Discovery filters for you.

Before you start

A product gets filter values only when all three are true:

  1. Its label is published. Drafts give no values. Products without a label have no values, so they are not listed when a shopper picks one of these filters.
  2. The switch is on. In the app, open Settings and pick Shopper filters in the menu on the left, turn on Let shoppers filter by allergen-free and click Save.
  3. The sync has finished. Turning the switch on syncs the labels you already published. Wait until the Existing labels section says the values are synced. If some products could not be synced, click Retry failed products.

Add the filter in Search & Discovery

  1. Open Search & Discovery and go to Filters. In Settings > Shopper filters of the app, Open Search & Discovery takes you there.
  2. Click Add filter.
  3. Choose the “Without <allergen> (per EU label)” entries you want, such as “Without milk (per EU label)”, and save.

The names and steps in Search & Discovery are set by Shopify and can look slightly different in your admin.

What the values mean

A value comes only from the product’s published label, “may contain” included: a product whose label lists milk, or says it may contain milk, is not “Without milk”. It is not a free-from claim, and the app does not check the product itself. Search & Discovery allows a limited number of filters per store, so add only the allergen groups your shoppers need.

Troubleshooting

  • The filter is not on my collection pages: check that you added it in Search & Discovery and that your theme shows collection filters.
  • A product is missing when a filter is picked: check that its label is published and, if you published it while the switch was off, click Sync existing labels (or Sync again) in Settings > Shopper filters.
  • I turned the switch off: the app stops updating the values, and values already written stay on your products. Remove the filter in Search & Discovery if you no longer want shoppers to see it.

Built and supported by StoreFleet, Shopify app developers since 2021.