Documentation

Tags & Filtering

Organize products and let customers filter by category.

What Are Tags?

Tags are flat labels you attach to products. They are not hierarchical — there are no parent or child tags. A single product can have multiple tags, and a single tag can be used 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

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

How Filtering Works

Tags double as filters on your shop page. Customers can click a tag to narrow down 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

Because the active tag is stored in the URL query string, you can link directly to a filtered view from anywhere:

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

Use these links in Ghost posts, emails, or your site navigation to send visitors straight to a specific category.

Tags in Breadcrumbs

The first tag on a product is used as its breadcrumb on the product page. For example:

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

Clicking the breadcrumb tag filters the shop to that tag.

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