README

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.

🏆 Kishan Savaliya

Top Rated Plus on Upwork

100% Job Success • 10+ Years Magento Experience Adobe Certified • Hyva Specialist

🏢 Panth Infotech Agency

Magento Development Team

Custom Modules • Theme Design • Migrations Performance • SEO • Adobe Commerce Cloud

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

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.

#	Badge Type	Trigger Rule	Typical Use Case
1	Sale	Product has a special price active	Flash sales, clearance, seasonal discounts
2	New Arrival	Product created within N days (configurable)	Promote fresh inventory and collections
3	Best Seller	Top N products by order quantity or revenue	Social proof, highlight popular items
4	Low Stock	Stock qty below configurable threshold	Urgency, scarcity-driven conversions
5	Out of Stock	Product is out of stock	Transparent inventory communication
6	Hot Deal	% discount exceeds configurable threshold	Highlight high-value discounts
7	Free Shipping	Product qualifies for free shipping	Reduce cart abandonment
8	Custom / Featured	Rule-based on any attribute, category, or SKU list	Campaigns, brand spotlights, exclusives

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

Requirement	Versions Supported
Magento Open Source	2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8
Adobe Commerce	2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8
Adobe Commerce Cloud	2.4.4 — 2.4.8
PHP	8.1.x, 8.2.x, 8.3.x, 8.4.x
MySQL	8.0+
MariaDB	10.4+
Hyva Theme	1.0+ (native support)
Luma Theme	Native support
Required Dependency	Panth_Core (free)

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-smart-badge
bin/magento module:enable Panth_Core Panth_SmartBadge
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

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

Verify Installation

bin/magento module:status Panth_SmartBadge
# Expected output: Module is enabled

After installation, navigate to:

Admin → Panth Infotech → Smart Badge → Manage Badges

Configuration

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

Setting	Default	Description
Enable Smart Badge	Yes	Master toggle for the module
New Arrival Threshold (Days)	30	Products created within N days receive the "New" badge
Low Stock Threshold (Qty)	5	Stock qty below this value triggers the "Low Stock" badge
Best Seller Top N	20	Top N products by order qty receive "Best Seller"
Hot Deal Discount Threshold	30	Discounts above N% receive the "Hot Deal" badge
Maximum Badges per Product	3	Cap on simultaneous badges per product
Enable Animations	Yes	Globally enable/disable CSS animations
Load FontAwesome	Auto	Auto / Always / Never — skip if your theme already loads FA
Enable on Category Pages	Yes	Show badges on product listings
Enable on Product Pages	Yes	Show badges on PDP
Enable on Cart	No	Show badges in cart line items

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

Trigger type — one of the 8 built-in types (Sale, New, Best Seller, etc.) or Custom
Conditions — optional additional filters (category, attribute set, SKU list, price range, customer group)
Schedule — optional start/end dates or recurring window
Design — visual styling (color, shape, icon, animation, position)
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:

Page Type	Available Positions
Category / Listing	Top-Left, Top-Right, Bottom-Left, Bottom-Right, Center Overlay
Product Detail (PDP)	On Main Image (9-point grid), Above Title, Beside SKU, Next to Price, Above Add to Cart
Home / Widgets	Inside Product Slider / Featured Grid blocks
Cart / Mini-Cart	Beside line item name (optional)
Search Autocomplete	Inline with product thumbnail

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

Animation	Effect	Best For
Pulse	Gentle rhythmic scale	Urgency badges (Low Stock, Hot Deal)
Shake	Horizontal jitter	Flash sales, limited-time
Bounce	Vertical hop	New arrivals
Glow	Soft outer light	Premium / Featured
Shine	Diagonal gradient sweep	Best Seller, Premium
Flip	3D rotation	Reveal effect
Fade	Opacity oscillation	Subtle, non-distracting

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

Channel	Contact
Email	kishansavaliyakb@gmail.com
Website	kishansavaliya.com
WhatsApp	+91 84012 70422
GitHub Issues	github.com/mage2sk/module-smart-badge/issues
Upwork (Top Rated Plus)	Hire Kishan Savaliya
Upwork Agency	Panth Infotech

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: kishansavaliyakb@gmail.com
📱 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

mage2kishan / module-smart-badge

Maintainers

Package info

Statistics

Security