Documentation

Tags & Filtering

Organize products and let customers filter by category.

What are tags?

Tags are flat labels you attach to products. There is no hierarchy, so no parent tags, no child tags, and no family tree to keep tidy. One product can carry many tags, and one tag can sit on any number of products.

Adding tags to products

  1. Edit a product and scroll to the Tags section
  2. Type a tag name and press Enter or comma to add it
  3. The tag appears as a pill
  4. Click the X on a pill to remove it
  5. Click Save when you're done

Tag examples

A few ways stores tend to slice things up:

  • Product type: t-shirts, hoodies, mugs
  • Collections: summer-collection, new-arrivals
  • Promotions: sale, clearance
  • Attributes: organic, handmade
  • Sizing: mens, womens, kids

How filtering works

Every tag doubles as a filter on your shop page. A customer clicks one to narrow the product list.

  1. Clicking a tag shows only products that have that tag
  2. Clicking the same tag again shows all products
  3. The URL updates (e.g. /shop?tag=sale) so filtered views are shareable

Instant filtering: Filtering happens in the browser with no page reload.

Tags in the URL

The active tag lives in the URL query string, so you can link straight to a filtered view from anywhere:

  • yoursite.com/shop?tag=sale
  • yoursite.com/shop?tag=new-arrivals

Drop these links into Ghost posts, emails, or your site navigation to send visitors right to a category.

Tags in breadcrumbs

The first tag on a product becomes its breadcrumb on the product page. For example:

  • With tags: Shop > T Shirts > Classic Tee
  • Without tags: Shop > Classic Tee

Clicking that breadcrumb tag filters the shop to it.

Put the most relevant tag first. It shows up in the breadcrumb navigation on product pages.

Best practices

  • First tag matters: it appears in breadcrumbs, so pick the most useful category
  • Keep tags simple: use lowercase, hyphenated names like new-arrivals
  • Be consistent: decide on a naming convention and stick with it across all products
  • Don't over-tag: 3-5 tags per product is usually enough

Last updated