Discount Label for Magento 2
Create Eye-Catching Hanging Discount Tags for Homepage, Product & Category Pages
Hikmadh Discount Label for Magento 2 is a lightweight promotional extension that allows you to display dynamic hanging discount tags on Homepage, Product, and Category pages. It gives full admin control over label text, colors, positioning, and page-specific variations, helping merchants highlight offers and increase customer engagement without impacting store performance.
✔ Separate label control for homepage display
✔ Dedicated settings for product detail pages
✔ Independent configuration for category pages
✔ Custom text, ribbon, and color management
✔ Adjustable position and hanging options
✔ Lightweight, responsive, performance optimized
Designed with flexibility in mind, the extension allows merchants to run page-specific promotions without modifying theme files or custom code. Each label section can be configured independently, ensuring consistent branding while adapting offers based on customer journey stages. Whether highlighting homepage campaigns, product discounts, or category-level promotions, Hikmadh Discount Label delivers a visually appealing and conversion-focused experience across your Magento 2 store.
Key Features
Page-Wise Configuration Control: Manage discount labels separately for Homepage, Product Detail, and Category pages with independent settings.
Homepage Promotional Display: Highlight special campaigns directly on the homepage with customizable text, ribbon content, and color styling.
Product Page Label Customization: Display targeted discount tags on product detail pages to increase visibility and improve purchase decisions.
Category Page Badge Support: Showcase promotional badges across category listings using a dedicated module configuration.
Advanced Text & Color Management: Fully customize main text, ribbon text, background colors, and font colors to match your store branding.
Flexible Position & Hanging Settings: Choose left or right alignment and control where the label hangs from within the header structure.
Smooth Animation Effect: Includes a subtle hanging swing animation that enhances attention without affecting store performance.
Admin-Based Configuration Panel: Configure and manage all label settings directly from the Magento Admin without modifying theme files.
Production-Ready Architecture: Built using Magento 2 best practices ensuring scalability, maintainability, and performance optimization.
Installation
System Requirements
Before installing the Hikmadh Discount Label extension, ensure your environment meets the following requirements:
Magento 2.4.x
PHP 7.4 or higher
Upload Extension Files
Extract the extension package and upload it to:
app/code/Hikmadh/DiscountLabel/
If using category module separately:
app/code/Hikmadh/ProductLabel/
Ensure folder structure remains intact after upload.
Enable the Module
Run the following Magento CLI commands:
php bin/magento module:enable Hikmadh_DiscountLabel
php bin/magento module:enable Hikmadh_ProductLabel
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush
Verify Installation
After running commands:
Navigate to:
Stores → Configuration → Hikmadh → Discount Label
Ensure:
Homepage configuration section appears, Product page configuration section appears, Category label options are available in product edit page.
Activate Discount Labels
- Set Enable = Yes
- Configure text, colors, position
- Save configuration
- Clear cache if required
Your discount labels will now appear on:
Homepage (Hanging label), Product page (Hanging + product image label), Category page (Product image label)
Configuration
Hikmadh Discount Label provides complete control over promotional label behavior directly from the Magento Admin panel.
Stores → Configuration → Hikmadh → Discount Label
Homepage Label Configuration
Enable Option – Activate or deactivate the discount label display for the homepage independently from other pages.
Main Text Setting – Define the primary heading text displayed prominently on the hanging label (e.g., “Special Offer”).
Sub Text Setting – Configure the supporting message displayed below the ribbon section (e.g., “On All Services”).
Ribbon Text Configuration – Set the promotional ribbon content such as percentage discounts or campaign highlights.
Ribbon Color (Hex) – Define the ribbon background color using hexadecimal values to match your branding guidelines.
Background Color (Hex) – Customize the main tag body background color for consistent design styling.
Text Color (Hex) – Control the font color of all label text elements for maximum readability.
Label Position Selection – Choose whether the label appears on the Header Left or Header Right of the screen.
Hang From Option – Select whether the label hangs visually from the Top Header area of your store layout.
Product Page Label Configuration
Enable Option – Control the visibility of discount labels specifically on product detail pages.
Main Text Setting – Define the primary heading text displayed on the product page label.
Sub Text Setting – Configure additional supporting text below the ribbon area.
Ribbon Text Configuration – Set promotional messaging such as discount percentages or limited-time offers.
Ribbon Color (Hex) – Customize the ribbon background color using hex values for design consistency.
Background Color (Hex) – Define the primary tag background color for product page labels.
Text Color (Hex) – Adjust the font color for all product label text elements.
Label Position Selection – Choose whether the label appears on the Header Left or Header Right area.
Hang From Option – Select whether the label hangs from the Menu Header or Top Header section.
Category Page Product Label Settings
Category page labels are managed through the separate Hikmadh_ProductLabel module and configured directly within each product.
Product Label Type – Choose between “Add Label By Text” or “Add Label By Image” options.
Product Label (Text Mode) – Define custom promotional text to display on category product listings.
Product Label Background Color – Set the background color of the category badge using hex values.
Product Label Text Color – Configure the font color used within the category label badge.
Product Label Shape – Select the preferred badge shape (e.g., Rectangle, Oval).
Product Label Image – Upload a custom promotional badge image when using image-based labels.
Why Choose Hikmadh Discount Label
Hikmadh Discount Label is designed to give Magento 2 store owners complete promotional control without complexity. From homepage hanging offers to product-level badges and category-based labels, everything is fully configurable from the admin panel — no core modifications required. The extension is lightweight, performance-friendly, and built following Magento best practices. With flexible positioning, customizable colors, multiple label types, and seamless storefront integration, it helps you highlight offers effectively while maintaining a clean and professional store design.
Whether you’re running seasonal sales, limited-time promotions, or featured product campaigns, Hikmadh Discount Label gives you the tools to showcase discounts clearly and convert more visitors into customers.