# Product tags

Source: https://support.storeconnect.com/articles/product-tags · Last modified 21 August 2026

Product tags are short labels that appear on a product card, such as `New`, `Sale`, or `Staff pick`. They are a merchandising tool: use them to draw attention to products in a category listing or search results. Customers can also filter search results by tag.

## How product tags are stored

A tag is two records, not one:

- **Tag** — the label itself. It belongs to a store, so each store has its own set of tags.
- **Product Tag** — a link between one **Tag** and one **Product**. Create one for each product you want the tag to appear on.

This means you create a tag once and reuse it across as many products as you like. Editing the tag updates every product showing it.

:::note
Tags belong to a single store. If you run more than one store and want the same label on both, create a **Tag** record for each store.
:::

## Create a tag

1. Open the **Store** record for the store the tag belongs to.
2. Go to the **Tags** related list and click **New**.
3. Fill in the fields:

| Field | What to enter |
| --- | --- |
| **Tag Name** | An internal name to identify the record. Customers never see this. |
| **Value** | The text customers see on the product card. Keep it short, for example `New` or `Sale`. |
| **Store** | The store this tag belongs to. |
| **Type** | Optional. See [Using the Type field](#using-the-type-field) below. |

4. Save the record.

:::warning
The badge shows the **Value** field, not **Tag Name**. If you leave **Value** blank, the tag still applies to the product but renders as an empty badge.
:::

## Apply a tag to a product

1. Open the **Product** record you want to tag.
2. Go to the **Product Tags** related list and click **New**.
3. Set **Tag** to the tag you created, and leave **Product** set to the current product.
4. Set **Position** if you want to control the order the badges appear in. See [Control the order badges appear in](#control-the-order-badges-appear-in) below.
5. Save the record.

The badge appears on the product card the next time the storefront loads that product.

To remove a tag from one product, delete its **Product Tag** record. The **Tag** record itself stays, along with every other product using it.

## Control the order badges appear in

A product can carry several tags. They render in ascending **Position** order, so a tag with **Position** `1` appears before one with **Position** `2`.

Product Tags with no **Position** set sort after all the ones that have a value, ordered by the date they were created. If badge order matters to you, set **Position** on every **Product Tag** for that product rather than only some of them.

## Let customers filter by tag

Tags are available as a filter in storefront product search. The filter lists only tags that appear on products in the current set of results, so a tag that matches nothing is never shown as an empty option.

No configuration is needed to turn this on. Create tags, apply them to products, and the filter appears.

## Using the Type field

**Type** is an optional classification on the **Tag** record with three values: `New`, `Exclusive`, and `Sale`. It exists so a theme can style or position tags differently depending on their type.

The standard theme does not read **Type**. Setting it changes nothing on the storefront on its own, so treat it as a hook for custom theme work rather than a setting that produces a visible result. Speak to whoever maintains your theme before relying on it.

## Styling tags

The standard theme renders each badge with a general CSS class plus one built from the tag's **Value**. A tag with a **Value** of `Sale` gets the class `SC-ProductCard_tag-sale`, and `Staff pick` gets `SC-ProductCard_tag-staff-pick`. Use those classes to give individual tags their own color or shape.

:::note
Because the class comes from **Value**, changing a tag's **Value** changes its CSS class and any styling attached to it stops applying. Update your theme styles at the same time.
:::

---

## Follow StoreConnect

- [Email Newsletter](https://getstoreconnect.com/c/lp-newsletter)
- [LinkedIn Newsletter](https://www.linkedin.com/build-relation/newsletter-follow?entityUrn=7444956928444862464)
- [YouTube](https://www.youtube.com/channel/UCngKdP2x8l1wcbAKW3tvU8g)
- [LinkedIn](https://www.linkedin.com/company/storeconnect)
- [X / Twitter](https://x.com/storeconnecthq)

## Popular Links

- [Partners](https://getstoreconnect.com/partners)
- [News](https://getstoreconnect.com/articles/news)
- [Events](https://getstoreconnect.com/articles/events)
- [Feature Comparison](https://getstoreconnect.com/how-we-compare)
- [Download a free trial](https://appexchange.salesforce.com/appxListingDetail?listingId=a0N3A00000FMkeKUAT)
- [Book a Demo](https://getstoreconnect.com/contact)

## Documentation

- [Help documentation](https://support.storeconnect.com/help-documentation)
- [AI agents](https://support.storeconnect.com/ai)
- [Videos & tutorials](https://support.storeconnect.com/videos-tutorials)
- [Developer reference](https://support.storeconnect.com/developer-reference)
- [Release notes](https://support.storeconnect.com/release-notes)
- [Troubleshooting](https://support.storeconnect.com/troubleshooting)
- [Trust Center](https://trust.getstoreconnect.com/)
- [Status Page](https://status.storeconnect.com/)

## Contact

- info@getstoreconnect.com
- US +1 415 745 3230
- AUS +61 2 8365 2308

100 S Ashley Dr, Suite 600-2461
Tampa FL 33602-600 USA

Level 22, Sydney Place
180 George Street
Sydney, NSW, 2000, AUS

---

StoreConnect Support — https://support.storeconnect.com/articles/product-tags