Product Tags¶
Menu Location: Products > Online Store > Product Tags
Overview¶
Product Tags let you label products with customer-facing keywords (dietary notes, sourcing attributes, seasonal collections, and so on) so shoppers can browse and search by those keywords in your online store. A tag only shows up to customers once it is linked to at least one active product.
Primary Functions:
- Create and edit the tags available in your store
- Mark specific tags as "Featured" so you can limit the shop sidebar to a curated set of tags
- Link tags to products (from the product's own edit page, or from the dedicated Tag Manager)
- Bulk-assign tags to products through the Products CSV import
Page Layout¶
Header Section¶
- Add New button - create a new tag
- Tag Manager button - opens the Product Tags Manager (see Assigning Tags to Products)
- Settings button - opens a modal to turn the "Featured Filter" on or off (see below), with a live Featured Filter: ON/OFF indicator next to it
Main Content Area¶
Like other admin list pages, this page supports Super Search (search/filter by column) and pagination. The list itself has two real fields per tag:
- Tag - the customer-facing tag text
- Featured Tag - Yes/No flag used by the Featured Filter setting
There is no "Slug", "Product Count", or "Created Date" column on this page. The count of active products linked to a tag is tracked internally and surfaced on the Tag Manager page (see below), not in this list.
Featured Filter setting¶
The Settings modal controls one store-wide option: "Enable featured tag filter for shop sidebar?"
- No - Show all tags (default): every tag with at least one active product appears in the shop sidebar
- Yes - Only show tags with "Featured Tag" = Yes: only tags you've flagged as Featured appear in the shop sidebar (other tags still work if a customer links to them directly, they just aren't listed)
Creating Product Tags¶
Add a New Tag¶
Steps:
- Click Add New
- Enter the Tag name
- Set Featured Tag to Yes if it should count toward the Featured Filter
- Save
Requirements:
- Tag name is required
- There is no separate "slug" field; the tag name itself is used in shop tag links
Editing Product Tags¶
Modify an Existing Tag¶
Steps:
- Find the tag in the list (use Super Search if needed)
- Open it for editing
- Update the Tag name and/or the Featured Tag flag
- Save
Impact of Editing:
- Renaming a tag changes what customers see immediately, on the shop sidebar, on the product page's tag labels, and in the tag's shop URL
- Product links to the tag are unaffected by a rename
Deleting Product Tags¶
Remove a Tag¶
Delete the tag from the list like any other row on this page. Products that were linked to the tag lose that tag; the products themselves are not affected.
Before deleting: check the Tag Manager dropdown (it shows each tag's active product count next to its name) so you know whether products are still using the tag.
Assigning Tags to Products¶
There are three real ways to link tags to products.
1. From the product's own edit page¶
On an existing product's edit page, the Product tags card (under "Store Tags & Filters") lets you:
- Type one or more tag names into the text box, separated by commas
- Click Add
- New tag names are created automatically if they don't already exist, and are linked to that product
- Existing tags on the product are shown as removable labels, click the X on a label to unlink it
A "edit all tags" link on this card jumps to the main Product Tags page.
2. Tag Manager (live search)¶
Go to Products > Online Store > Product Tags Manager (or click Tag Manager on the Product Tags page):
- Choose a tag from the dropdown (each option shows the tag name, its current active-product count, and
[Featured]if flagged) - Type in the search box to find active products by name
- Click a search result to link that product to the tag
- Hover a linked product and click Remove to unlink it
Changes save instantly, there is no separate "Save" step.
3. CSV import¶
The Products page's CSV import supports a tags column. Enter comma-separated tag names per product row; on import, any tag name that doesn't already exist is created and linked to that product automatically.
Common Use Cases¶
Use Case 1: Create Dietary Preference Tags¶
Goal: Help customers filter by dietary needs
Steps:
- Click Add New and create tags such as "Gluten-Free", "Dairy-Free", "Vegan", "Keto-Friendly", "Paleo"
- Link each tag to the relevant products using the product edit page or the Tag Manager
Result: Customers see these tags in the shop sidebar (once each tag has at least one active product) and can browse by them.
Use Case 2: Seasonal Product Organization¶
Goal: Create tags for seasonal products
Steps:
- Create seasonal tags such as "Summer Favorites" or "Fall Harvest"
- Link them to seasonal products via the product edit page or Tag Manager
- Unlink products (or leave the tag with no active products) once the season ends, rather than deleting the tag, so it's ready to reuse next year
Use Case 3: Special Product Collections¶
Goal: Group products for marketing campaigns
Steps:
- Create a campaign tag, e.g. "Father's Day Gifts"
- Use the Tag Manager to quickly search and link gift boxes or bundles to it
- Reference the tag's shop link in email marketing
Use Case 4: Cleanup Unused Tags¶
Goal: Remove outdated or unused tags
Steps:
- Open the Tag Manager dropdown, it lists every tag with its current active-product count
- Identify tags at 0 (or very low) product counts
- Delete tags that are no longer needed from the Product Tags page
Use Case 5: Limit the Sidebar to Curated Tags¶
Goal: Only show a hand-picked set of tags to customers instead of every tag in use
Steps:
- On the Product Tags page, edit the tags you want to promote and set Featured Tag to Yes
- Open Settings and turn on "Enable featured tag filter for shop sidebar?"
- Only the Featured tags now appear in the shop sidebar; other tags still work if linked directly
Tag Strategy & Organization¶
Recommended Tag Categories¶
Dietary & Health:
- Gluten-Free, Dairy-Free, Vegan, Vegetarian
- Keto, Paleo, Low-Carb
Sourcing & Quality:
- Organic, Local, Grass-Fed, Wild-Caught
Preparation:
- Ready-to-Cook, Fresh, Frozen
Marketing:
- New Arrival, Best Seller, Seasonal Special
These are naming suggestions only, none of these categories exist as system features, they're just a way to think about organizing your own tags.
Tag Naming Conventions¶
Effective Tag Names¶
Do:
- Use clear, customer-friendly language
- Be consistent with capitalization
- Use full words, not abbreviations
Don't:
- Use internal jargon or codes
- Create overly broad tags ("Good")
- Duplicate information already in the product name or classification
Examples:
| Good Tag Names | Poor Tag Names |
|---|---|
| Gluten-Free | GF |
| Grass-Fed Beef | grass_fed |
| New Arrival | new! |
Troubleshooting¶
Tag Not Appearing in the Shop Sidebar¶
Check:
- Is the tag linked to at least one active product? (see the count in the Tag Manager dropdown)
- Is the Featured Filter turned on, and this tag's Featured Tag set to No? Turn Featured Tag on for this tag, or turn the filter off in Settings.
- On the main Products page settings, is "Hide product tags to customers" (the
hide_product_tagssetting) turned on? If so, tags are hidden on individual product pages (this does not affect the sidebar).
Duplicate Tags¶
Symptoms: Multiple similar tags (e.g. "Gluten Free" and "Gluten-Free")
Steps:
- Pick the tag name you want to keep
- Use the Tag Manager to link the affected products to the preferred tag and unlink them from the duplicate
- Delete the duplicate tag from the Product Tags page
Prevention: Search existing tags (Super Search) before creating a new one.
Renamed Tag Still Shows Old Name¶
Renaming a tag on the Product Tags page updates it everywhere it's used (sidebar, product page labels, tag URL). If an old name still appears, it's likely a page or browser cache, refresh the page.
Related Pages¶
- Products (
product_classifications_active.php) - the individual product edit page's "Product tags" card is where you link tags to a single product - Product Tags Manager (
product-tags-manager.php) - link/unlink products to a tag with live search - Product Attributes (
admin-edit.php?table=product_attr) - a separate, more structured attribute system for products - Store Categories (
store-cats.php) - organize products by store category - Featured Products Sort (
featured-products-sort.php) - control the order featured products display in
Typical Workflow:
- Create tags on this page
- Link them to products, either from the product's own edit page or from the Tag Manager
- Tags appear in the shop sidebar automatically once linked to an active product
Best Practices¶
Tag Creation Strategy¶
- Plan tag categories that align with how customers actually search
- Start with a small core set and expand as needed
- Be consistent with naming and capitalization
- Use the Featured Filter if you want to limit the sidebar to a curated subset instead of showing every tag
Tag Maintenance¶
- Periodically check the Tag Manager dropdown for tags with 0 or very few linked products
- Consolidate near-duplicate tags into one
- Remove seasonal tags' product links (or delete the tag) when the season ends
Tag Assignment¶
- Products can have multiple tags, link generously where accurate
- Only tag a product with attributes that truly apply
- Use the CSV
tagscolumn for bulk assignment during product import instead of tagging one product at a time
Quick Reference Card¶
| Task | Action/Location |
|---|---|
| Create new tag | Product Tags page > Add New |
| Edit tag name or Featured flag | Product Tags page > open tag > Save |
| Delete unused tag | Check Tag Manager's product count first, then delete from Product Tags page |
| Find a specific tag | Super Search on Product Tags page |
| See how many products use a tag | Tag Manager dropdown |
| Link a tag to a product (one at a time, live search) | Product Tags Manager |
| Link a tag to a product (from the product itself) | Product edit page > Store Tags & Filters > Product tags |
| Bulk-link tags on import | Products CSV import > tags column |
| Limit sidebar to curated tags | Product Tags page > Settings > Featured Filter |
FAQs¶
What's the difference between tags and product classifications?¶
Classifications are your internal, hierarchical product organization (a classification can have a parent classification). Tags are flat, customer-facing keywords used for browsing and search, a product can have any number of tags regardless of its classification.
Can customers see all my product tags?¶
Only tags linked to at least one active product appear in the shop sidebar. If the Featured Filter is on, only tags flagged Featured show in the sidebar (a tag can still be reached directly by its shop link even if hidden from the sidebar).
What happens to products if I delete a tag?¶
Products remain unchanged, they simply lose that tag association.
Can I bulk-assign tags to multiple products?¶
Yes, use the tags column in the Products CSV import. For linking one tag to several products interactively, use the Tag Manager's live search instead of tagging products one at a time.
Where do tags show up to customers?¶
In the shop sidebar's tag list, as clickable labels on the product's own page (unless "Hide product tags to customers" is turned on for the store), and in shop search suggestions.