Magento 2 Product Labels Extension – User Guide

This document provides a comprehensive guide for the Toweringmedia Product Labels Extension for Magento 2. It is intended for store administrators and developers who want to create, configure, and manage product labels across their Magento store. The extension allows administrators to display customizable labels such as Sale, New, Best Seller, Featured, and promotional badges on products based on configurable rules and conditions.

The Toweringmedia Product Labels Extension for Magento 2 allows store administrators to create and display customizable labels on products throughout the storefront. These labels can be used to highlight important product information, promotions, special offers, or product characteristics.

The extension provides flexible options for creating labels using text or images and controlling where and when they appear. Labels can be assigned manually to products or automatically based on configurable product conditions and rules.

Store administrators can use the extension to display labels such as Sale, New, Best Seller, Featured, Limited Stock, or other promotional badges. Labels can also be scheduled for specific periods, making the extension suitable for seasonal campaigns, limited-time promotions, and other time-sensitive offers.

The extension supports displaying product labels in multiple areas of the Magento storefront, including product listings, product detail pages, search results, related products, upsell products, and cross-sell products. Multiple labels can also be displayed on the same product when required.

The Product Labels Extension is designed to provide Magento store owners with greater control over product presentation while allowing labels to be customized according to the store's branding and promotional requirements.

The Toweringmedia Product Labels Extension provides the following key features:

• Custom Product Labels – Create custom labels to highlight specific products with promotional or informational messages.

• Text and Image Labels – Use text-based labels or upload images to create visually attractive product badges.

• Rule-Based Label Assignment – Automatically assign labels to products based on configurable product conditions and rules.

• Multiple Labels per Product – Display multiple labels on the same product when more than one condition or promotion applies.

• Customizable Label Appearance – Configure the label design, including its text, image, position, and other visual properties.

• Flexible Display Locations – Display labels in different areas of the Magento storefront, including product listing pages and product detail pages.

• Search Result Labels – Display product labels on products shown in Magento search results.

• Related, Upsell, and Cross-Sell Labels – Show labels on products displayed in related product, upsell, and cross-sell sections.

• Scheduled Labels – Configure start and end dates to automatically display labels during a specific period.

• Promotional Campaign Support – Use labels for sales, seasonal campaigns, limited-time offers, new products, featured products, and other promotions.

• Customer Group Support – Configure label visibility based on Magento customer groups when applicable.

• Store View Support – Manage label visibility and configuration for different Magento store views.

• Responsive Storefront Display – Product labels are designed to work across different screen sizes and storefront layouts.

• Magento Multi-Store Support – Manage product labels in Magento environments with multiple websites, stores, and store views.

• Easy Label Management – Administrators can create, update, enable, disable, and manage product labels from the Magento Admin Panel.

The Toweringmedia Product Labels Extension enhances the Magento 2 storefront by allowing store administrators to add visual labels and badges to products. These labels help customers quickly identify important product information, promotions, and special offers while browsing the store.

The extension can be used to:

• Create custom product labels using text or images.
• Highlight products with labels such as Sale, New, Best Seller, Featured, or Limited Stock.
• Automatically assign labels to products based on configured conditions and rules.
• Manually control which products display a particular label.
• Display multiple labels on a single product when multiple rules apply.
• Configure the appearance and position of labels on the storefront.
• Display labels on product listing and product detail pages.
• Display labels in search results.
• Display labels for related products, upsell products, and cross-sell products.
• Schedule labels to appear and disappear automatically using start and end dates.
• Control label visibility according to store views and customer groups.
• Use labels to support seasonal promotions, sales campaigns, product launches, and other marketing activities.
• Provide customers with quick visual indicators without requiring them to open each product to view additional information.

Please refer to the installation guide in the following article https://toweringmedia.com/installation

The Product Labels Extension provides a dedicated section in the Magento Admin Panel for creating and managing product labels.

Navigate to the Product Labels section in the Magento Admin Panel to view and manage existing labels.

The Product Labels grid provides the following information:

• Label ID – Unique identifier of the label.
• Name – Name assigned to the label.
• Status – Indicates whether the label is enabled or disabled.
• Source Type – Indicates how products are selected for the label, such as manual assignment.
• Label Type – Indicates the type of label, such as text, image, or shape.
• Priority – Determines the processing priority of the label.
• From Date – Start date from which the label becomes active.
• To Date – End date after which the label is no longer active.
• Updated At – Date and time when the label was last updated.
• Action – Provides actions for managing the label.

Click Add New Label to create a new product label.

The label configuration page contains several sections that allow the administrator to define the label, select products, configure display locations, and customize its appearance.

The General section contains the basic label configuration.

Enable or disable the label using the Status option.

• Yes – The label is active.
• No – The label is disabled.

Enter a unique name for the label.

The name is used to identify the label in the Magento Admin Panel.

Enter a numeric priority for the label.

Priority can be used to control the processing order when multiple labels apply to the same product.

Enable this option when the label should also be applicable to child products of Configurable, Bundle, or Grouped products.

Select the Magento stores/store views where the label should be available.

This allows administrators to use different labels or label configurations across multiple store views.

Select the customer groups for which the label should be displayed.

The available customer groups may include:

• NOT LOGGED IN
• General
• Wholesale
• Retailer

Enable Stop Processing when the current label should prevent further label processing according to the extension's priority and processing rules.

The Products Selection section determines which products will receive the label.

Select how products should be assigned to the label.

The extension provides an option for Only manually assigned products, while condition-based product selection can also be configured through product conditions.

When Only manually assigned products is selected, enter the product IDs in the Manual Product IDs field.

Product IDs should be entered as comma-separated values.

Example:

101,105,110,125

Select the storefront areas where the label should be displayed.

Available locations shown in the configuration include:

• Category Product Tile
• Product Detail Page
• Related Product
• Upsell Product
• Cross-sell Product
• Cart Item

A label can therefore be displayed in multiple product presentation areas across the Magento storefront.

The Product Conditions section allows administrators to control label assignment based on product conditions.

Specify the date from which the label should become active.

Specify the date until which the label should remain active.

These fields can be used to schedule labels for temporary promotions and campaigns.

Configure conditions that determine which products match the label.

The extension provides a condition builder where administrators can define rules using product attributes and other available product conditions.

The matching products section can be used to review products that satisfy the configured conditions.

The Source Type option determines how the label's product selection is sourced.

For manually selected products, Manual can be selected as the source type.

The extension provides tooltip configuration for product labels.

Enable or disable the tooltip.

Specify the background color used for the tooltip.

Specify the color of the tooltip text.

Enter the tooltip content that should be displayed when the customer interacts with the label.

The tooltip supports variables such as:

• `{$SKU}`
• `{$NAME}`
• `{$PRICE}`
• `{$SAVE_PERCENT}`
• `{$SAVE_AMOUNT}`
• `{$STOCK}`
• `{$NEW_FOR}`
• `{$ATTR:code}`
• `{$BR}`

Basic HTML tags can also be used where supported.

The label appearance can be configured separately for different storefront areas.

The configuration provides options for:

• Label Type
• Shape
• Label Position
• Label Text
• Text Color
• Text Size
• Image
• CSS Class
• Container Style

Select how the label should be rendered.

The available configuration can include:

• Text Only
• Image
• Text & Image

Select the shape used for the label.

For example, None (default chip) can be used for a standard label appearance.

Select the position of the label using the 3 × 3 position selector.

The available positions are:

• Top-left
• Top-center
• Top-right
• Center-left
• Center
• Center-right
• Bottom-left
• Bottom-center
• Bottom-right

Enter the text that should be displayed on the label.

The label text supports product-related variables, including:

• `{$SKU}`
• `{$NAME}`
• `{$PRICE}`
• `{$SPECIAL_PRICE}`
• `{$FINAL_PRICE}`
• `{$SAVE_PERCENT}`
• `{$SAVE_AMOUNT}`
• `{$STOCK}`
• `{$NEW_FOR}`
• `{$ATTR:code}`
• `{$BR}`

These variables allow the label to display dynamic product information.

Select the color of the label text.

Specify the font size of the label text in pixels.

Example:

14

Upload an image to use as the product label.

The Admin Panel provides options to:

• Upload an image.
• Select an existing image from the gallery.

The supported image formats and maximum file size are displayed in the corresponding configuration section.

Enter a custom CSS class for the label.

This can be used when additional storefront styling is required.

Enter inline CSS for the label container.

For example:

padding:4px 8px; background:#eb5202;

The Category Page section controls how the label is displayed on category product tiles.

Administrators can configure:

• Label Type
• Shape
• Label Position
• Label Text
• Text Color
• Text Size
• Image
• CSS Class
• Container Style

The configuration includes a preview area so the administrator can visualize the label placement.

The Product Page section controls label display on the individual product detail page.

The same customization options can be configured for the product page, including label type, shape, position, text, color, size, image, CSS class, and container styling.

This allows the label appearance on the product detail page to be controlled independently from the category product listing.

The extension also provides configuration for labels displayed in cart-related areas.

The Hide Label on Pages option can be used to select pages where the label should not be displayed.

Available options shown in the configuration include:

• Shopping Cart Page
• Mini-Cart
• Checkout Page

If no option is selected, the label can remain visible on the applicable cart, mini-cart, and checkout areas when those locations are included in Display On.

Product labels are displayed directly on product images or product presentation areas, allowing customers to identify important product information while browsing the store.

On category pages, labels can appear directly on product tiles.

For example, a store can display labels such as:

• New
• Featured
• Trending
• 50% off
• Free Delivery
• SALE

The label position can be configured by the administrator using the label position settings.

Labels can be displayed independently for different products, allowing customers to quickly identify products associated with specific promotions or characteristics.

On the product detail page, the label can be displayed alongside the product image.

This provides customers with an immediate visual indication of the product's status or promotion before they proceed with the purchase.

For example, a product can display a Featured label above the product image.

Depending on the administrator's configuration, product labels can also appear in:

• Related products
• Upsell products
• Cross-sell products
• Cart items
• Mini-cart
• Checkout

This allows the same promotional or informational message to remain visible as customers move through different parts of the shopping journey.

Customers see labels according to the configuration defined by the administrator.

Labels can use:

• Text
• Images
• Different shapes
• Custom positions
• Custom text colors
• Custom text sizes
• Custom CSS styling

This allows labels to match the visual design of the Magento storefront.

Labels can display dynamic product information using supported variables.

For example, a label can be configured to display the product name, SKU, price, special price, stock information, or calculated savings.

This allows administrators to create labels that automatically reflect product-specific information without manually creating separate label text for every product.

When Active From Date and Active To Date are configured, labels can be displayed only during the specified period.

This is useful for:

• Seasonal promotions
• Limited-time offers
• Sale campaigns
• Product launches
• Promotional events

Once the configured active period ends, the label is no longer displayed according to the extension's scheduling rules.

When tooltips are enabled, customers can receive additional information associated with a product label.

The tooltip can contain static text as well as supported dynamic product variables, allowing customers to see additional product information without leaving the current page.

• Verify that the extension is successfully installed and enabled.
• Verify that the Product Labels section is available in the Magento Admin Panel.
• Verify that a new product label can be created successfully.
• Verify that the label Status can be enabled and disabled.
• Verify that the label Name is required.
• Verify that the Priority value is accepted and used when multiple labels apply to the same product.
• Verify that labels can be assigned to the required Store Views.
• Verify that labels can be restricted to selected Customer Groups.
• Verify that the Use for Child Products option works correctly for configurable, bundle, and grouped products.
• Verify that Stop Processing works correctly when multiple labels match the same product.
• Verify that products can be selected manually using product IDs.
• Verify that product conditions can be configured and matching products are displayed correctly.
• Verify that Active From Date and Active To Date correctly control label visibility.
• Verify that labels can be displayed on supported locations, including:
  • Category Product Tile
  • Product Detail Page
  • Related Product
  • Upsell Product
  • Cross-sell Product
  • Cart Item
• Verify that labels can be hidden on:
  • Shopping Cart Page
  • Mini-Cart
  • Checkout Page
• Verify that the available Label Types work correctly, including text, image, and text & image options where supported.
• Verify that different label shapes can be selected and displayed correctly.
• Verify that all available label positions work correctly.
• Verify that custom Label Text is displayed correctly.
• Verify that supported product variables such as `{$SKU}`, `{$NAME}`, `{$PRICE}`, `{$SPECIAL_PRICE}`, `{$FINAL_PRICE}`, `{$SAVE_PERCENT}`, `{$SAVE_AMOUNT}`, `{$STOCK}`, `{$NEW_FOR}`, and `{$ATTR:code}` are replaced with the correct product values.
• Verify that `{$BR}` creates the expected line break in label text.
• Verify that the configured Text Color and Text Size are applied correctly.
• Verify that uploaded label images are displayed correctly.
• Verify that supported image formats and configured file-size limits are enforced.
• Verify that labels can use images selected from the Magento media gallery.
• Verify that custom CSS Class values are applied correctly.
• Verify that Container Style values are applied correctly.
• Verify that tooltip functionality works when enabled.
• Verify that tooltip text, tooltip color, and tooltip text color are applied correctly.
• Verify that tooltip variables and basic HTML formatting work as expected.
• Verify that labels are displayed correctly on the frontend product listing page.
• Verify that labels are displayed correctly on the frontend product detail page.
• Verify that labels do not interfere with product images, product names, prices, ratings, or Add to Cart controls.
• Verify that labels remain properly positioned across different product image sizes.
• Verify that labels display correctly on desktop and mobile layouts.
• Verify that inactive, expired, or disabled labels are not displayed on the storefront.
• Verify that labels are displayed correctly after Magento cache is refreshed.
• Verify that multiple labels applied to the same product follow the configured priority and processing rules.

If a configured label is not visible on the storefront:

• Verify that the label Status is set to Yes.
• Check that the correct Store View is selected.
• Verify that the current customer belongs to a selected Customer Group.
• Check the Active From Date and Active To Date settings.
• Verify that the product is included in the configured product selection or product conditions.
• Confirm that the label is configured for the correct Display On location.
• Check whether the label has been configured to be hidden on the current page.
• Clear Magento cache and refresh the storefront.

Check the Display On configuration for the label. The extension supports different product locations, such as:

• Category Product Tile
• Product Detail Page
• Related Product
• Upsell Product
• Cross-sell Product
• Cart Item

Make sure the required location is selected.

Also check the Hide Label on Pages configuration for Shopping Cart, Mini-Cart, and Checkout pages.

If a product does not match the label:

• For manually assigned products, verify that the correct Product IDs are entered.
• For condition-based labels, review the configured Product Conditions.
• Use the Matching Products section in the Admin Panel to confirm which products match the configured conditions.
• Verify that the product status and visibility allow it to appear on the storefront.

If multiple labels match the same product:

• Check the Priority value of each label.
• Review the Stop Processing setting.
• Verify that the expected label has the appropriate priority.
• Make sure there are no overlapping product conditions causing an unexpected label to be selected.

Check the Customer Groups configuration of the label.

Make sure the intended customer group is selected and test the storefront using an account belonging to that customer group. Also test the page as a guest if NOT LOGGED IN is selected.

For configurable, bundle, or grouped products, check the Use For Child Products setting.

Enable this option when the label should also apply to the associated child products.

If an image-based label is not visible:

• Verify that an image has been uploaded or selected from the gallery.
• Check that the selected file uses a supported format.
• Verify that the image does not exceed the configured maximum file size.
• Confirm that the label type supports the uploaded image.
• Check the browser developer console for image-loading or permission errors.

If the tooltip does not appear:

• Verify that Tooltip Enabled is set to Yes.
• Confirm that Tooltip Text contains content.
• Check the configured tooltip colors to ensure the text is visible.
• If variables are used, verify that the variable syntax is correct.
• Clear Magento cache and test again.

If the label is not positioned or styled as expected:

• Verify the selected Label Position.
• Check the selected Shape.
• Review the Text Size and Text Color settings.
• Check whether a custom CSS Class is overriding the label styling.
• Review the Container Style for custom CSS that may affect positioning or appearance.
• Test the label with the default styling to determine whether the issue is caused by custom CSS.

If changes made in the Admin Panel are not immediately visible:

1. Save the label configuration.
2. Clear Magento cache.
3. Refresh the storefront page.
4. If applicable, flush the relevant cache types.
5. Test the page in a private/incognito browser window to rule out browser caching.

If labels overlap product content or other labels:

• Review the selected label position.
• Check the label text length.
• Reduce the configured Text Size if necessary.
• Review custom Container Style and CSS.
• If multiple labels apply to the same product, review their Priority and Stop Processing settings.
• Test the layout on different screen sizes to ensure responsive behavior.