Storefront filter URLs now use stable identifiers instead of text values

Published

This summary was written by ShopDigest AI from Shopify Changelog’s report. Read the full story ↗

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.

Overview

Starting March 16, 2026, Shopify storefront filter URLs will use stable group identifiers instead of text values when filtering by a filter group. For example, a color filter URL will change from ?filter.v.option.color=Blue to ?filter.v.option.color=gid://shopify/FilterSettingGroup/123. The change makes filtered links more reliable across languages and when filter labels are renamed, and all previously created filter URLs will continue to work.

What Changed

  • Filter group values in storefront URLs now use stable identifiers such as gid://shopify/FilterSettingGroup/123 instead of text like Blue.
  • The update applies to text-based filters like product options, bringing them in line with other filter types.
  • Existing storefront filter URLs remain functional after the change.

Why It Matters

Stable identifiers keep filtered collection and search links working when filter labels are renamed or when the storefront serves multiple languages. Merchants and developers relying on filter URLs for navigation, SEO, or campaigns do not need to update existing links.

About this story

Published
16 Mar 2026
Originally published at