Manage Labels

Product Labels are markers which are placed on top of product images at Catalog and Product pages. Using these marks, you can easily promote your new product or boost sales during marketing campaigns.

All Labels are located at the Marketing -> Product Labels -> Manage Labels section. From there, you can edit, remove, or create a new label.

How to Create New Label

Visit the Marketing -> Product Labels -> Manage Labels section and press the Add New button. Labels creation is broken into two Stages, one of which selects the Label Type, and the second gives details of their application.

The first stage consists of the following fields:

  • Title - a logical title of the label.
  • Placeholder - a placeholder which will be used as a framework for your label. Read more at the Placeholders section.
  • Relation Type - a type of label which needs to be created.
    • Attribute - a simple label that is displayed when the product has a selected attribute value.
    • Rule - a complex label that uses conditions to determine when a label needs to be applied.
  • To proceed to the next stage, press the Continue button.

The next stage contains detailed information about label displaying. General Information is displayed for both types of Label, and consists of the following fields:


  • Is Active - indicates whether the label is active and ready to apply.
  • Active From, Active To - time bounds when a label should be applied. Very useful for planning Sales campaigns.
  • Visible In - stores where the label needs to be applied.
  • Visible for Customer Groups - customer groups who are eligible to see labels.
  • Sort Order - priority order in which labels are applied to products.

Attribute-based Labels Setup

If Attribute was selected in the previous stage of Relation Type, the second stage will feature an additional field in the General Tab:

  • Attribute - selects the attribute that is used as a condition to display certain labels. These attributes can be viewed and even created at Stores -> Attributes -> Product section.

You can bind different labels for different attribute values, using the additional tab Gallery that is featured in this type of Label. It can contain zero or more rows with the following label definitions:

  • Option - a value of the selected attribute, which triggers a label display.
  • Product List Image - image will be displayed overlapping product images at list pages, such as Category or Search Results.
  • Title - logical title for a label (for product list image).
  • Description - short description of label's purpose (for product list image).
  • URL - URL associated with the label which is useful for campaigns (for product list image).
  • Product View Image - image which will be displayed overlapping product images at the Product View pages.
  • Title - logical title for a label (for product view image).
  • Description - short description of the label's purpose (for product view image).
  • URL - URL associated with the label, which is useful for campaigns (for product view image).

Rule-based Labels Setup

If Rule was selected as the Relation Type in the previous Stage, the Second Stage will feature two additional tabs: Conditions and Design.

At the Conditions tab, you will see a conditional block, which allows you to filter products to which labels should be applied, as shown on the screenshot:


All conditionals should be enclosed in the global mode block. They have four possible global modes of applying, shown in the special header If *[apply mode]* of these conditions are *[validation mode]*:

Applying modes define, when rule shall be triggered:

  • ALL - implies that the rule will be executed only when all conditions are strictly met;
  • ANY - implies that the rule will be executed only when one or more (but not all) of conditions are met;

Validation modes define which result can produce each condition to be registered as "met":

  • TRUE - implies that the conditions need to be valid.
  • FALSE - implies that the conditions need to be invalid.

You can also define multiple nested mode blocks by selecting the Conditions Combination option. These modes allow for creating flexible condition sets to satisfy a policy of any complexity.

Once you have selected global mode (or left it as default), press the green (+) button, and select a condition type. There are three categories of available conditions:

  • Product

    Contains three base attributes which are used for identifying products:

    • Attribute Set - a set of attributes defining a particular type of product (e.g. jewelry, for example). All these sets can be seen at Stores -> Attributes -> Attribute Set.
    • Category - one or more categories where the product needs to be registered.
    • SKU - direct value, or pattern (using contains operator), that needs to be in the product's SKU code.


  • Product Attribute

    Contains all attributes, defined at Stores -> Attributes -> Product, the most interesting of which are:

    • New - allows to check whether the product is New.
    • Format - a digital form of product (useful for downloadable products)


  • Product Additional

    Contains special attributes that can be used for building complex campaigns:

    • Created At - checks how many days ago the product was added to the store.
    • Updated At - checks how many days ago the product was last changed.
    • Percent Discount - analyzes which discount was applied to this particular product.


      Only discounts that have been applied directly to the products are analyzed. They are created at Marketing -> Catalog Price Rules.
    • Price - Final Price - is the final price, calculated after the application of all discounts and special price rules, which customers will actually pay.
    • Quantity - the quantity of a product which is currently in stock. This is useful when you need to mark the product as sold out.
    • Set As New - checks whether the product was set as new (including old products, returned as new arrivals).


At the Design tab, you can specify label appearance options:


  • Image - uploads label which will be added to the product image.
  • Position - sets the position of the label on the product image.


    The Position is calculated from two directions: vertical and horizontal.
    Vertical are:

    • Left
    • Center
    • Right

    Horizontal are:

    • Top
    • Middle
    • Bottom

    If you wish to position the label to the upper right corner, select in the drop-down list Top Right option.

  • Style - additional CSS styles that should be applied to the label.
  • Title - sets title on the label.
  • Description - sets label description.
  • Url - sets URL key of label.