Product Labels feature overviewEdit on GitHub
The Product Label feature lets product catalog managers highlight the needed products by adding a special type of information—product labels.
A product label is a sales-related piece of information conveying a message about the product to a buyer.
The product labels are applied to products to be displayed on their product cards and product details pages.
Product label on a product card—Storefront
Product label on a product details page—Storefront
A Back Office user can create product labels and assign them to products in the Back Office.
A developer can create dynamic product labels.
Dynamic product label
Dynamic product label is a product label that follows the condition rules defined on a code level. Unlike the regular product label, the dynamic product label is automatically applied to the product that fulfills the condition rules. A developer can edit the rules or create new dynamic product labels. The following dynamic product labels are shipped by default:
The Discontinued product label is added when you discontinue a product. The label is active until the product becomes inactive. To learn more, see Discontinuing a product.
The Alternatives available product label goes along with the Discontinued product label. It is added when you discontinue a product that has existing alternative products. The label is active until the product becomes inactive. To learn more, see Adding product alternatives.
The NEW label is added when you create a product. It is active for the time period defined inclusively in the New from and New to fields. To learn more, see Creating an abstract product.
The SALE product label is added to a product automatically when the product’s original price is superior to the default price. To learn more, see Creating an abstract product.
A default price shows the current value of the product on Storefront.
An original price is displayed as a strikethrough to identify that the value of the product has been decreased as if there is a promotion.
Product label design
A Back Office user can select the design and the position of the product label on a product card. The following label designs are shipped by default:
When creating a product label, a Back Office user selects a design by entering its name as a Front-end Reference. To learn more, see Creating product labels
If the product label designs shipped by default are not sufficient for your project, a developer can create new HTML classes to use as a Front-end Reference.
Product label priority
When several product labels are applied to a product, all of them are displayed on its product card and product details page.
A Back Office user can define the order in which product labels are displayed on the product card and product details page by entering a Priority value when creating a product label.
The product labels are displayed in ascending order of Priority. So, the label with the smallest priority value always goes first while the product label with the highest Priority value goes last.
In the preceding figure, the priority value of the Alternatives available product label is 4. The Priority value of the Discontinued product label is 5.
To learn how a Back Office user can define the product label priority, see Creating product labels.
Product label store relations
A Back Office user can define the stores each product label is displayed in. For example, if a promotion campaign targets Germany, the Sale product label can be displayed only in the DE store.
To learn how a Back Office user can define store relation for a product label, see Creating product labels.
A developer can also import store relations for product labels.
Product label statuses
A product label can have the following statuses:
If a product label is active, it is displayed on all the product pages it is applied to. If a product label is inactive, it is still applied to the selected product, but it is not displayed on the respective product pages. This might be useful when you want to prepare for an event beforehand. You can create an inactive product label and apply it to the needed products. When the event starts, you just need to activate the label to show it on all the product pages it is applied to.
To learn how a Back Office user can activate and deactivate product labels in the Back Office, see Edit product labels
Product label exclusivity
The Exclusive product label is a product label that, when applied to a product, discards all the other product labels applied to it. The other product labels are still applied to the product, but only the exclusive one is displayed on the respective product card and product details page. This might be useful when running several discounts in a store at the same time. By assigning the labels with corresponding discount names to needed products, you can show the shop users to which products each discount is applied.
To learn how a Back Office user can create an exclusive product label, see Creating product labels.
Product label filtering on the Storefront
Shop users can view product cards with labels on any Storefront page. Also, they can filter products by labels on category and search results pages.
Related Business User documents
|BACK OFFICE USER GUIDES|
|Create product labels|
|Edit product labels|
Related Developer documents
|INSTALLATION GUIDES||UPGRADE GUIDES||GLUE API GUIDES|
|Product Labels feature integration||ProductLabel migration guide||Retrieving product labels|
|Glue API: Product Labels feature integration||ProductLabelGui migration guide|
|[ProductLabelSearch migration guide](/docs/pbc/all/product-information-management/202204.0/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-productlabelsearch-module.html|
|[ProductLabelStorage migration guide](/docs/pbc/all/product-information-management/202204.0/base-shop/install-and-upgrade/upgrade-modules/upgrade-the-productlabelstorage-module.html|
For submitting the form