March 16, 2026

Storefront filter URLs now use stable identifiers instead of text values

Starting March 16, 2026, storefront filter URLs use stable group identifiers instead of text values when filtering by a filter group. Previously, filtering a collection or search results page using a text-based filter like product option "Color" produced a URL like this for filter group values:

yourstore.com/collections/all?filter.v.option.color=Blue

These URLs now use a stable group identifier:

yourstore.com/collections/all?filter.v.option.color=gid://shopify/FilterSettingGroup/123

What you need to do

If you've shared URLs with filters in ad campaigns, emails, social media posts, or anywhere on or outside your Shopify store, those links will no longer apply the expected filters.

To get the updated URLs:

  1. Go to the collection page in your online store
  2. Select the filters you want
  3. Copy the updated URL from your browser's address bar
  4. Replace the old links wherever they were shared

Filter navigation within your store works as expected — customers selecting filters on your storefront will automatically get the correct URLs.

Why we made this change

Stable identifiers make links with filters more reliable across languages and when filter labels are renamed. This brings text-based filters in line with how all other filter types already work.