{"title":"Product tags","slug":"product-tags","url":"https://support.storeconnect.com/articles/product-tags","url_markdown":"https://support.storeconnect.com/articles/product-tags.md","subtitle":null,"summary":"Add short labels such as New or Sale to product cards, and let customers filter search results by them.","type":"Help_Documentation","video_url":"","keywords":"product tags, tags, product badges, product labels, new tag, sale tag, merchandising, product card, search filters, product discovery, tag value, tag type","last_modified":"2026-08-21T07:12:35+0000","body_markdown":"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.\n\n## How product tags are stored\n\nA tag is two records, not one:\n\n- **Tag** — the label itself. It belongs to a store, so each store has its own set of tags.\n- **Product Tag** — a link between one **Tag** and one **Product**. Create one for each product you want the tag to appear on.\n\nThis means you create a tag once and reuse it across as many products as you like. Editing the tag updates every product showing it.\n\n:::note\nTags 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.\n:::\n\n## Create a tag\n\n1. Open the **Store** record for the store the tag belongs to.\n2. Go to the **Tags** related list and click **New**.\n3. Fill in the fields:\n\n| Field | What to enter |\n| --- | --- |\n| **Tag Name** | An internal name to identify the record. Customers never see this. |\n| **Value** | The text customers see on the product card. Keep it short, for example `New` or `Sale`. |\n| **Store** | The store this tag belongs to. |\n| **Type** | Optional. See [Using the Type field](#using-the-type-field) below. |\n\n4. Save the record.\n\n:::warning\nThe 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.\n:::\n\n## Apply a tag to a product\n\n1. Open the **Product** record you want to tag.\n2. Go to the **Product Tags** related list and click **New**.\n3. Set **Tag** to the tag you created, and leave **Product** set to the current product.\n4. 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.\n5. Save the record.\n\nThe badge appears on the product card the next time the storefront loads that product.\n\nTo remove a tag from one product, delete its **Product Tag** record. The **Tag** record itself stays, along with every other product using it.\n\n## Control the order badges appear in\n\nA product can carry several tags. They render in ascending **Position** order, so a tag with **Position** `1` appears before one with **Position** `2`.\n\nProduct 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.\n\n## Let customers filter by tag\n\nTags 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.\n\nNo configuration is needed to turn this on. Create tags, apply them to products, and the filter appears.\n\n## Using the Type field\n\n**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.\n\nThe 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.\n\n## Styling tags\n\nThe 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.\n\n:::note\nBecause 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.\n:::"}