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

We made this change because 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.

Please note that all former storefront filter URLs you have created will continue to work as expected.