Download the PHP package mage2kishan/module-smart-badge without Composer

Panth Smart Product Badges & Labels for Magento 2

Turn every product into a conversion opportunity with automated, rule-based badges and labels. Smart Badge for Magento 2 lets you promote sale items, new arrivals, best-sellers, low-stock products, and custom campaigns — without touching a single product manually.

Panth Smart Badge is a powerful Magento 2 product badge extension that assigns visual labels to products automatically based on flexible rules — sale status, new arrivals, best-sellers, low stock, custom attributes, categories, and more. Design eye-catching badges with a visual builder featuring custom colors, FontAwesome icons, animations, and gradients. Schedule badges to appear during promotions, target specific categories or individual products, and control positioning per page type (product listing, product detail, home, cart). Fully compatible with Hyva and Luma themes, MEQP compliant, and built for Magento 2.4.4 - 2.4.8 on PHP 8.1 - 8.4.

Whether you're running a flash sale, launching a new collection, highlighting bestsellers, or creating urgency around low-stock inventory, Smart Badge gives you the tools to drive conversions with zero manual product tagging.

🚀 Need Custom Magento 2 Development?

Get a free quote for your project in 24 hours — custom modules, Hyva themes, performance optimization, M1→M2 migrations, and Adobe Commerce Cloud.

Visit our website: kishansavaliya.com  |  Get a quote: kishansavaliya.com/get-quote

Table of Contents

• The 8 Built-In Badge Types
• Key Features
• Compatibility
• Installation
• Configuration
• How Badge Rules Work
• Badge Positioning & Page Targeting
• FontAwesome Icons & Animations
• Scheduling Badges
• Hyva & Luma Theme Support
• Performance
• FAQ
• Support
• About Panth Infotech
• Quick Links

The 8 Built-In Badge Types

Smart Badge ships with 8 pre-configured badge types that cover the most common merchandising scenarios. Each is fully customizable and can be enabled, disabled, restyled, or scheduled independently.

Key Features

Rule-Based Automatic Assignment

• No manual tagging — badges are applied automatically based on live product data
• Multi-condition rules — combine price, stock, category, attribute, and date filters
• Priority control — when multiple badges match, choose which ones display (and in what order)
• Product/category targeting — include or exclude specific SKUs, categories, or attribute sets
• Customer group targeting — show different badges to retail vs. wholesale customers

Visual Badge Builder

• Color picker — custom background, border, and text colors with gradient support
• Shape library — rectangle, rounded, pill, ribbon, corner, circle, diamond, and banner shapes
• Size presets — small, medium, large, or custom pixel dimensions
• FontAwesome 6 icons — hundreds of icons including fire, bolt, clock, star, heart, tag, gift
• Live preview — see your badge rendered in real-time in the admin builder
• CSS-free — no stylesheet editing required for standard designs

Animations & Effects

• Pulse, shake, bounce, glow, flip, fade — pre-built CSS animations
• Hover effects — scale, rotate, color-shift on mouseover
• Shine/shimmer — animated gradient sweep for premium feel
• Respects prefers-reduced-motion — accessible by default

Scheduling & Campaigns

• Start/end dates — badges appear and disappear automatically on schedule
• Timezone-aware — respects store timezone configuration
• Recurring schedules — daily/weekly windows (e.g., "Weekend Sale" every Fri-Sun)
• Store-view and website scoping — different badges per region/language

Page-Specific Positioning

• Category/listing pages — top-left, top-right, bottom-left, bottom-right, center overlay
• Product detail page — on main image, above title, beside SKU, next to price
• Home page / widgets — show in featured product sliders and PageBuilder blocks
• Cart & mini-cart — optional badges in cart line items
• Search results — badges visible in autocomplete and results grids

Admin Experience

• Grid management — filter, sort, bulk-enable, duplicate, and export badge rules
• MEQP compliant — passes Adobe's Magento Extension Quality Program
• Multi-store support — scope every badge to website / store view
• Translation ready — all admin labels use Magento's __() translation function

Compatibility

Installation

Composer Installation (Recommended)

Manual Installation via ZIP

1. Download the latest release ZIP from Packagist or the Adobe Commerce Marketplace
2. Extract to app/code/Panth/SmartBadge/ in your Magento installation
3. Also install the free Panth_Core base module
4. Run the same commands as above starting from bin/magento module:enable

Verify Installation

After installation, navigate to:

Configuration

Navigate to Stores → Configuration → Panth Extensions → Smart Badge to configure global settings:

How Badge Rules Work

Each badge in the admin grid is a rule — a combination of conditions that must be true for the badge to appear on a product.

Rule Components

1. Trigger type — one of the 8 built-in types (Sale, New, Best Seller, etc.) or Custom
2. Conditions — optional additional filters (category, attribute set, SKU list, price range, customer group)
3. Schedule — optional start/end dates or recurring window
4. Design — visual styling (color, shape, icon, animation, position)
5. Priority — integer controlling display order when multiple badges match

Example: "Winter Clearance" Rule

• Trigger: Sale (special price active)
• Conditions: Category = "Winter Collection" AND Discount >= 40%
• Schedule: 2026-01-01 00:00 — 2026-02-28 23:59
• Design: Red pill shape, white text, snowflake icon, pulse animation
• Position: Top-left on category page, beside price on PDP
• Priority: 10 (highest)

Badge Positioning & Page Targeting

Smart Badge gives you independent control over where each badge appears across your storefront:

Each badge rule can specify a different position per page type — e.g., a "Sale" badge might be top-right on listings but next-to-price on the PDP.

FontAwesome Icons & Animations

Smart Badge bundles FontAwesome 6 Free support with optional auto-loading. Choose from hundreds of icons including:

• Urgency/Scarcity: fire, bolt, clock, hourglass-half, exclamation
• Value: tag, percent, dollar-sign, gift, coins
• Popularity: star, heart, crown, thumbs-up, trophy
• Freshness: leaf, seedling, sparkles, certificate
• Shipping: truck, shipping-fast, box

Built-In Animations

All animations honor the prefers-reduced-motion media query for accessibility.

Scheduling Badges

Every badge rule supports time-based activation:

• One-time window — set a specific start and end datetime (e.g., Black Friday 2026)
• Recurring schedule — weekly windows (e.g., "Weekend Sale" every Fri 18:00 → Sun 23:59)
• Evergreen — no schedule; badge is always active when trigger conditions are met
• Timezone-aware — all times respect the store's configured timezone

The scheduler runs via Magento's cron, so ensure bin/magento cron:run is scheduled in your system crontab.

Hyva & Luma Theme Support

Smart Badge is one of the few Magento 2 badge extensions with first-class Hyva support:

• Hyva — native Alpine.js components, Tailwind CSS classes, no jQuery, fully compatible with Hyva's checkout and PageBuilder
• Luma — traditional RequireJS + Knockout components for classic storefronts
• Theme detection — automatic via Panth\Core\Helper\Theme (no manual configuration)
• Zero conflicts — badge markup is isolated and does not interfere with your theme's existing CSS

Performance

• Indexed rules — badge-to-product assignments cached and indexed for O(1) lookups
• Block caching — badge HTML is cached per product + store view + customer group
• Lazy icon loading — FontAwesome loaded only on pages where badges render
• Zero frontend JS overhead — pure CSS animations; no JavaScript required for display
• MEQP compliant — passes Adobe's code quality standards

Typical performance impact: < 5ms added to category page render on a store with 10,000 products and 15 active badge rules.

FAQ

Does Smart Badge slow down my category pages?

No. Badge lookups are indexed and cached per product + store view + customer group, and badge rendering is pure CSS. Typical overhead is under 5ms on listing pages.

Can I create my own custom badges?

Yes. Use the Custom / Featured badge type and define rules based on any product attribute, category, SKU list, or price condition.

Does it work with configurable and bundle products?

Yes. Badges apply at the parent-product level on listing pages and follow your theme's configurable/bundle display logic on the PDP.

Will badges appear in product sliders and PageBuilder?

Yes. Smart Badge integrates with Magento's native product list blocks, PageBuilder product widgets, and popular slider extensions including Panth Product Slider.

Can I schedule a badge for a specific campaign?

Yes. Each rule supports a start/end datetime or a recurring weekly window, all timezone-aware.

Does it work with Hyva themes?

Yes. Smart Badge ships native Hyva support — Alpine.js + Tailwind, no jQuery — detected automatically via Panth Core's theme helper.

Is the source code available?

Yes. The full source is on GitHub at github.com/mage2sk/module-smart-badge.

Does Smart Badge support multi-store and multi-language?

Yes. Every badge rule is scopable to website / store view, and all text fields are translatable via Magento's __() function.

What if my theme already loads FontAwesome?

Set Load FontAwesome to Never in configuration to skip loading it a second time.

Can I limit how many badges show per product?

Yes. The Maximum Badges per Product config (default 3) caps simultaneous badges. Rule priority determines which ones display when more match than allowed.

Support

Response time: 1-2 business days.

💼 Need Custom Magento Development?

Looking for custom Magento module development, Hyva theme customization, store migrations, or performance optimization? Get a free quote in 24 hours:

About Panth Infotech

Built and maintained by Kishan Savaliya — kishansavaliya.com — a Top Rated Plus Magento developer on Upwork with 10+ years of eCommerce experience.

Panth Infotech is a Magento 2 development agency specializing in high-quality, security-focused extensions and themes for both Hyva and Luma storefronts. Our extension suite covers SEO, performance, checkout, product presentation, customer engagement, and store management — over 34 modules built to MEQP standards and tested across Magento 2.4.4 to 2.4.8.

Browse the full extension catalog on the Adobe Commerce Marketplace or Packagist.

Quick Links

• 🌐 Website: kishansavaliya.com
• 💬 Get a Quote: kishansavaliya.com/get-quote
• 👨‍💻 Upwork Profile (Top Rated Plus): upwork.com/freelancers/~016dd1767321100e21
• 🏢 Upwork Agency: upwork.com/agencies/1881421506131960778
• 📦 Packagist: packagist.org/packages/mage2kishan/module-smart-badge
• 🐙 GitHub: github.com/mage2sk/module-smart-badge
• 🛒 Adobe Marketplace: commercemarketplace.adobe.com
• 📧 Email: [email protected]
• 📱 WhatsApp: +91 84012 70422

Ready to boost conversions with smart product badges?

SEO Keywords: magento 2 product badges, sale badge, new arrival badge, product labels, smart badges, urgency badges, magento 2 label extension, best seller badge magento 2, low stock badge, out of stock badge magento, hot deal badge, free shipping badge, hyva product badges, luma product labels, magento 2 product label extension, rule-based badges magento, scheduled product badges, fontawesome magento badges, animated product labels, category badge magento 2, product detail page badge, magento 2 merchandising, conversion rate optimization magento, urgency marketing magento, scarcity badges, magento 2.4.8 badges, php 8.4 magento module, panth smart badge, panth infotech, mage2kishan, mage2sk, kishan savaliya magento, top rated plus magento freelancer, hire magento developer upwork, custom magento development, magento 2 hyva development