Skip to content

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.

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:

  1. Click Add New
  2. Enter the Tag name
  3. Set Featured Tag to Yes if it should count toward the Featured Filter
  4. 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:

  1. Find the tag in the list (use Super Search if needed)
  2. Open it for editing
  3. Update the Tag name and/or the Featured Tag flag
  4. 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:

  1. Type one or more tag names into the text box, separated by commas
  2. Click Add
  3. New tag names are created automatically if they don't already exist, and are linked to that product
  4. 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.

Go to Products > Online Store > Product Tags Manager (or click Tag Manager on the Product Tags page):

  1. Choose a tag from the dropdown (each option shows the tag name, its current active-product count, and [Featured] if flagged)
  2. Type in the search box to find active products by name
  3. Click a search result to link that product to the tag
  4. 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:

  1. Click Add New and create tags such as "Gluten-Free", "Dairy-Free", "Vegan", "Keto-Friendly", "Paleo"
  2. 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:

  1. Create seasonal tags such as "Summer Favorites" or "Fall Harvest"
  2. Link them to seasonal products via the product edit page or Tag Manager
  3. 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:

  1. Create a campaign tag, e.g. "Father's Day Gifts"
  2. Use the Tag Manager to quickly search and link gift boxes or bundles to it
  3. Reference the tag's shop link in email marketing

Use Case 4: Cleanup Unused Tags

Goal: Remove outdated or unused tags

Steps:

  1. Open the Tag Manager dropdown, it lists every tag with its current active-product count
  2. Identify tags at 0 (or very low) product counts
  3. 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:

  1. On the Product Tags page, edit the tags you want to promote and set Featured Tag to Yes
  2. Open Settings and turn on "Enable featured tag filter for shop sidebar?"
  3. Only the Featured tags now appear in the shop sidebar; other tags still work if linked directly

Tag Strategy & Organization

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:

  1. Is the tag linked to at least one active product? (see the count in the Tag Manager dropdown)
  2. 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.
  3. On the main Products page settings, is "Hide product tags to customers" (the hide_product_tags setting) 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:

  1. Pick the tag name you want to keep
  2. Use the Tag Manager to link the affected products to the preferred tag and unlink them from the duplicate
  3. 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.


  • 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:

  1. Create tags on this page
  2. Link them to products, either from the product's own edit page or from the Tag Manager
  3. Tags appear in the shop sidebar automatically once linked to an active product

Best Practices

Tag Creation Strategy

  1. Plan tag categories that align with how customers actually search
  2. Start with a small core set and expand as needed
  3. Be consistent with naming and capitalization
  4. Use the Featured Filter if you want to limit the sidebar to a curated subset instead of showing every tag

Tag Maintenance

  1. Periodically check the Tag Manager dropdown for tags with 0 or very few linked products
  2. Consolidate near-duplicate tags into one
  3. Remove seasonal tags' product links (or delete the tag) when the season ends

Tag Assignment

  1. Products can have multiple tags, link generously where accurate
  2. Only tag a product with attributes that truly apply
  3. Use the CSV tags column 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.