Differences

This shows you the differences between two versions of the page.

--- magento2:extensions:magento-2-product-labels [2026/08/20 23:53] – created - external edit 127.0.0.1
+++ magento2:extensions:magento-2-product-labels [2026/09/01 20:54] (current) – swatwik
@@ Line 1: / Line 1: @@
-====== Toweringmedia Product Labels Extension User Guide ======
+====== Magento 2 Product Labels Extension – User Guide ======
-===== Related overview =====
+===== Extension context =====
-For a shopper-friendly overview of features and setup, see the [[https://toweringmedia.com/magento-2-product-labels-user-guide|Magento 2 Product Labels User Guide - Sale & New Badges]] on the storefront. This wiki page remains the full technical documentation.
+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.
-===== Extension context =====
+===== Overview =====
-This is a Toweringmedia Magento 2 extension guide for the current admin extension catalog.
+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.
-===== Product page =====
+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.
-  * [[https://toweringmedia.com/toweringmedia-product-labels-extension|Toweringmedia Product Labels Extension]] (SKU ''tm-product-labels'')
+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.
-===== Overview =====
+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.
-This extension adds merchandising labels and badges — Sale, New, Out of Stock, and any custom badge you define — to product images on category listings and product pages. Labels are created once and then applied through rules, so badges appear automatically as catalog conditions change rather than being set product by product.
+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.
+===== Key features =====
+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.
 ===== What this extension does =====
-  * Create reusable image or text labels and badges.
+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.
-  * Apply labels automatically through rules rather than per-product edits.
-  * Display labels on category listing and product detail pages.
-  * Limit how many labels can appear on a single product.
-  * Optionally hide labels whose variables resolve to empty or zero.
-===== Requirements =====
+The extension can be used to:
-  * Magento 2.4.x (Open Source or Adobe Commerce).
+  * Create custom product labels using text or images.
-  * PHP: ^8.1 || ^8.2 || ^8.3 || ^8.4 (as declared by the published package).
+  * Highlight products with labels such as **Sale**, **New**, **Best Seller**, **Featured**, or **Limited Stock**.
-  * A current Toweringmedia license and Composer credentials for ''https://composer.toweringmedia.com/''.
+  * Automatically assign labels to products based on configured conditions and rules.
-  * Composer resolves ''toweringmedia/module-base'' automatically.
+  * 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.
 ===== Installation =====
-Install and validate in a staging environment before production rollout.
+Please refer to the installation guide in the following article [[https://toweringmedia.com/installation|https://toweringmedia.com/installation]]
-<code bash>
+===== Admin setup =====
-cd /path/to/magento
-composer require toweringmedia/module-product-labels
-bin/magento module:enable Toweringmedia_ProductLabels
+The Product Labels Extension provides a dedicated section in the Magento Admin Panel for creating and managing product labels.
-bin/magento setup:upgrade
-bin/magento setup:di:compile
+==== Product Labels grid ====
-bin/magento setup:static-content:deploy -f
-bin/magento cache:flush
+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.
+{{:magento2:extensions:label-grid.png?400|}}
+==== Creating a 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.
+==== General ====
+The **General** section contains the basic label configuration.
+=== Status ===
+Enable or disable the label using the **Status** option.
+  * **Yes** – The label is active.
+  * **No** – The label is disabled.
+=== Name ===
+Enter a unique name for the label.
+The name is used to identify the label in the Magento Admin Panel.
+=== Priority ===
+Enter a numeric priority for the label.
+Priority can be used to control the processing order when multiple labels apply to the same product.
+=== Use For Child Products ===
+Enable this option when the label should also be applicable to child products of **Configurable, Bundle, or Grouped** products.
+=== Stores ===
+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.
+=== Customer Groups ===
+Select the customer groups for which the label should be displayed.
+The available customer groups may include:
+  * NOT LOGGED IN
+  * General
+  * Wholesale
+  * Retailer
+=== Stop Processing ===
+Enable **Stop Processing** when the current label should prevent further label processing according to the extension's priority and processing rules.
+{{:magento2:extensions:label-new-general.png?400|}}
+==== Products Selection ====
+The **Products Selection** section determines which products will receive the label.
+=== Products Selection ===
+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.
+=== Manual Product IDs ===
+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:
+<code>
+,105,110,125
 </code>
-Currently published versions at the time of writing:
+=== Display On ===
-  * ''toweringmedia/module-product-labels'' — 1.0.4
+Select the storefront areas where the label should be displayed.
-Toweringmedia packages are served from the licensed Composer repository ''https://composer.toweringmedia.com/''. If Composer reports that the package could not be found, your credentials are missing or the license does not cover this package yet. Retrieve your keys from **My Account** on toweringmedia.com, or contact [[mailto:support@toweringmedia.com|support@toweringmedia.com]].
+Available locations shown in the configuration include:
-General installation notes that apply to every Toweringmedia extension are in the [[https://toweringmedia.com/installation|installation guide]].
+  * Category Product Tile
+  * Product Detail Page
+  * Related Product
+  * Upsell Product
+  * Cross-sell Product
+  * Cart Item
-===== Configuration =====
+A label can therefore be displayed in multiple product presentation areas across the Magento storefront.
-  * Stores > Configuration > **Catalog** > **Product Labels** (config section ''toweringmedia_productlabels''). Note this section sits under the **Catalog** tab, not the Towering Media tab.
+==== Product Conditions ====
-  * Groups: ''general'' (enable, debug, image base path, hide empty or zero variables) and ''limits'' (default maximum labels per product).
-  * Admin screens: Catalog > Product Labels > **Manage Labels** and **Manage Rules**.
-===== Basic usage and what to expect =====
+The **Product Conditions** section allows administrators to control label assignment based on product conditions.
+=== Active From Date ===
+Specify the date from which the label should become active.
+=== Active To Date ===
+Specify the date until which the label should remain active.
+These fields can be used to schedule labels for temporary promotions and campaigns.
+=== Product Conditions ===
+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.
+==== Source Type ====
+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.
+==== Tooltip ====
+The extension provides tooltip configuration for product labels.
+=== Enabled ===
+Enable or disable the tooltip.
+=== Tooltip Color ===
+Specify the background color used for the tooltip.
+=== Tooltip Text Color ===
+Specify the color of the tooltip text.
+=== 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.
+==== Label appearance ====
+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
+{{:magento2:extensions:label-new-selection1.png?400|}}
+=== Label Type ===
+Select how the label should be rendered.
+The available configuration can include:
+  * **Text Only**
+  * **Image**
+  * **Text & Image**
+=== Shape ===
+Select the shape used for the label.
+For example, **None (default chip)** can be used for a standard label appearance.
+=== Label Position ===
+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
+=== Label Text ===
+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.
+=== Text Color ===
+Select the color of the label text.
+=== Text Size ===
+Specify the font size of the label text in pixels.
+Example:
+<code>
+
+</code>
+=== Image ===
+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.
+=== CSS Class ===
+Enter a custom CSS class for the label.
+This can be used when additional storefront styling is required.
+=== Container Style ===
+Enter inline CSS for the label container.
+For example:
+<code>
+padding:4px 8px; background:#eb5202;
+</code>
+==== Category Page ====
+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.
+{{:magento2:extensions:label-new-category.png?400|}}
+==== Product Page ====
+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.
+{{:magento2:extensions:label-new-product.png?400|}}
+==== Cart, Mini-Cart and Checkout Pages ====
+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**.
+{{:magento2:extensions:label-new-minicart.png?400|}}
+===== Frontend user experience =====
+Product labels are displayed directly on product images or product presentation areas, allowing customers to identify important product information while browsing the store.
+==== Category and product listing pages ====
+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.
+{{:magento2:extensions:label-new-product-list.png?400|}}
+==== Product detail page ====
+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.
+==== Multiple product presentation areas ====
+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.
+{{:magento2:extensions:label-new-product-details.png?400|}}
+==== Label customization experience ====
+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.
+==== Dynamic label information ====
+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.
+==== Scheduled label visibility ====
+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.
+==== Tooltip experience ====
+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.
-  - Create the label artwork or text under Catalog > Product Labels > Manage Labels.
-  - Create a rule under Manage Rules that decides which products receive that label.
-  - Flush cache and check a category page to confirm the badge renders in the expected position.
 ===== Validation checklist =====
-  * ''bin/magento module:status'' shows the module(s) as enabled.
+  * Verify that the extension is successfully installed and enabled.
-  * Extension configuration saves without errors in Admin.
+  * Verify that the **Product Labels** section is available in the Magento Admin Panel.
-  * The admin screens listed above are reachable and load without error.
+  * Verify that a new product label can be created successfully.
-  * Expected storefront/admin behavior is present after a cache flush.
+  * Verify that the label **Status** can be enabled and disabled.
-  * No critical PHP/JS errors appear in ''var/log/'' during the primary test flow.
+  * 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.
 ===== Troubleshooting =====
-  * **Composer cannot find the package**: confirm the ''https://composer.toweringmedia.com/'' repository and your credentials are present in ''auth.json'', and that your license covers this package.
+==== Product label is not displayed on the frontend ====
-  * **Feature not visible**: verify module status, flush cache, and redeploy static content.
-  * **Admin setting not applying**: clear cache and confirm the config scope (default / website / store view).
+If a configured label is not visible on the storefront:
-  * **Unexpected behavior**: retest with only the required related modules enabled.
+  * 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.
+==== Label appears on some pages but not others ====
+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.
+==== Product is not included in the label ====
+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.
+==== Wrong label is displayed when multiple labels apply ====
+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.
+==== Label is displayed for the wrong customer group ====
+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.
+==== Label is not displayed for child products ====
+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.
+==== Label image is not displayed ====
+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.
+==== Tooltip is not working ====
+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.
+==== Label position or appearance is incorrect ====
+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.
+==== Label changes are not visible after saving ====
+If changes made in the Admin Panel are not immediately visible:
-===== Support =====
+  - Save the label configuration.
+  - Clear Magento cache.
+  - Refresh the storefront page.
+  - If applicable, flush the relevant cache types.
+  - Test the page in a private/incognito browser window to rule out browser caching.
-  * [[mailto:support@toweringmedia.com|support@toweringmedia.com]]
+==== Labels overlap or affect the product layout ====
-  * [[https://toweringmedia.com/magento-maintenance-support|Magento maintenance and support]]
-===== Related Magento 2 docs =====
+If labels overlap product content or other labels:
-  * [[magento2:extensions:start|Magento 2 extension index]]
+  * Review the selected label position.
-  * [[start|Global docs home]]
+  * 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.