Collection Tag Pills Setup Guide

This guide explains how to set up Collection Tag Pills so customers can quickly filter products within a collection page.

Where to Set It Up

1. Open Shopify Admin.
2. Go to Online Store, then Themes.
3. Select Customize.
4. Open a collection template.
5. Select the Main collection section.
6. In Collection navigation settings, configure Collection Tag Pills.

Section Settings

Collection Tag Pills are controlled in Main collection.

Setting	Default	What it controls
Show collection tag pills	On	Shows or hides tag filter pills above collection results.
Collection tag pill limit	12	Maximum number of tag pills shown (from collection tags).

Shopify Admin Setup

Collection Tag Pills use product tags from products inside the current collection.

1. Open Products in Shopify Admin.
2. Add clear, customer-friendly tags to products.
3. Use consistent tag naming across products in the same collection.
4. Save product updates.

Tags from products in the collection feed the available pills automatically.

How It Works for Customers

1. Customers see a Shop all products pill and tag pills.
2. Clicking a tag pill filters the collection to that tag.
3. Clicking an active tag pill clears that tag filter and returns to the full collection view.
4. If sorting is selected, sort order is preserved while using tag pills.

Tag Naming Best Practices

Use tags that read well as visible UI labels.

• Keep tags short and clear.
• Prefer customer-friendly wording, not internal abbreviations.
• Avoid duplicate tags with different capitalization or punctuation.
• Use one naming pattern consistently, such as lower-case hyphenated tags.

Troubleshooting

Issue	Check	Fix
Tag pills do not appear	Show collection tag pills is off	Turn on Show collection tag pills in Main collection settings.
Fewer pills appear than expected	Collection tag pill limit is too low	Increase Collection tag pill limit.
A tag is missing	No products in this collection use that tag	Add the tag to products that belong to the collection.
Pill labels look inconsistent	Product tags are inconsistent	Standardize tag naming across products.
Filter clears unexpectedly	Customer clicked the active tag pill	This is expected behavior and returns to full collection view.

Final Check Before Publish

1. Open the target collection page in Theme Editor preview.
2. Confirm Shop all products and tag pills are visible.
3. Click multiple pills to verify filter behavior.
4. Confirm active pill state is clear and easy to understand.
5. Confirm sorting remains applied when switching pills.