Collection tag permalinks

Definition

Collection tag permalinks are Shopify's original filtering mechanism. Appending one or more product tags to a collection path returns that collection narrowed to products carrying those tags, rendered server-side at a crawlable URL, with the active tags exposed to the template in Liquid. The mechanism predates the native filter objects and still works alongside them.

Documented at https://shopify.dev/docs/storefronts/themes/navigation-search/filtering/tag-filtering.

How we've used it

Tag permalinks survive on collection pages that have to offer more than one kind of narrowing. Where a filter rail mixes native facets, tag links and merchandiser-defined groups in a single interface, the tag path is what backs the group: a merchandiser names a set of tags in the theme editor and gets a URL a shopper can bookmark and a crawler can reach, without that set having to exist as a filter in the admin. It also keeps a narrowed view addressable while the grid is being re-rendered client-side. We don't build new filtering on it — native facets are the better primitive and they carry counts — but we keep it working where a live catalog and its existing links already depend on it.

Builds using it

One gated build uses it.

Related entities

Storefront filtering · Liquid pagination · Storefront search · Section Rendering API