Documentation
WooCommerce Products Badge Management
Version 6.0.0
Introduction
WooCommerce Products Badge Management is a powerful and flexible badge system for WooCommerce that allows you to create and manage custom badges for your products. Whether you need “New Arrival” badges, category-specific badges, or custom product badges, this plugin provides an intuitive interface with live preview and extensive customization options.
- Highlighting new products
- Creating category-specific promotions
- Adding custom badges to individual products
- Managing variation-specific badges
- Building brand consistency with custom designs
Requirements
- WordPress: 6.5 or higher
- WooCommerce: 5.0 or higher (tested up to 10.0.5)
- PHP: 7.4 or higher
Features
Multiple Badge Types
- New Arrival badges with configurable days
- Category-specific badges
- Individual product badges
- Variation-specific badges
Preset Library
- 33+ professionally designed SVG badges
- Organized by badge type
- Instant preview and selection
Custom Design Options
- Custom text and colors
- Adjustable padding and margins
- Border radius controls
- Opacity settings
- Custom image upload
Live Preview
- Real-time design updates
- Drag to position
- See changes instantly
Smart Priority System
- Variation badges (highest)
- New arrival badges
- Product-specific badges
- Category badges
- Global badges (lowest)
Performance Optimized
- Built-in caching system
- Minimal database queries
- Optimized for block themes
Theme Compatibility
The plugin automatically detects your theme type and uses the appropriate display method:
- Classic Themes & Block Themes – Full support for both traditional and FSE themes including Twenty Twenty-Four, Twenty Twenty-Five, Storefront, Astra, Flatsome, and all popular WooCommerce themes
Caching System
- Product-specific badge caching (1 hour expiration)
- Automatic cache clearing on badge updates
- Parent product cache clearing when variations change
- Category-based cache invalidation
Variation Switching
For variable products, badges update in real-time as customers select different variations, showing variation-specific badges when assigned.
Badge Previews
Installation
Standard Installation
-
Download the Plugin
Download the plugin ZIP file from CodeCanyon
-
Upload to WordPress
Go to WordPress Admin → Plugins → Add New → Click “Upload Plugin” and select the downloaded ZIP file
-
Install and Activate
Click “Install Now” and then “Activate”
-
Automatic Check
The plugin will automatically check for WooCommerce
-
Access the Plugin
A new menu item “Product Badges” will appear in your admin sidebar
FTP Installation
-
Extract Files
Extract the plugin ZIP file on your computer
-
Upload via FTP
Upload the
woocommerce-badges-managementfolder to/wp-content/plugins/ -
Activate
Go to WordPress Admin → Plugins → Find “WooCommerce Badges Management” and click “Activate”
Getting Started
Quick Start Guide
-
Create Your First Badge
Go to Product Badges → Add New. Give your badge a title and configure its settings.
-
Choose Badge Type
Select from New Arrival, Category Badge, or Product Badge based on your needs.
-
Design Your Badge
Use preset images or customize colors, text, padding, and position with live preview.
-
Configure Display Settings
Go to Product Badges → Display Settings to control where badges appear.
-
Assign Badges
For product badges: Edit a product and select your badge in the “Product Badge” meta box.
Creating and Customizing Badges – Step by Step
-
Start Creating
Go to > Product Badges → Add New > in your WordPress admin.
-
Enter a Title
Enter a title for the badge (internal name, e.g., “Seasonal New Arrival”).
-
Select Badge Type
Select the Badge Type – New Arrival, Category Badge, or Product Badge.
-
Configure Assignment
For Category Badges, choose assignment: Global (all products) or Specific Categories (select categories).
-
Set New Arrival Days
For New Arrival badges, set the number of days a product is considered “new” (default 7).
-
Choose Badge Style
Choose between a preset image, a custom uploaded image, or a text badge.
-
Customize Text Badge
If using a text badge , customize the text, colors, padding, border radius, and opacity.
-
Adjust Position
Adjust the badge position by dragging the live preview or entering top/left margin values.
-
Publish
Click Publish to save your badge.
Configuration Notes Per Type
- New Arrival badges: Only the “New Arrival Days” field is configurable – no category assignment needed.
- Category Badges: Can be global or category-specific. Category hierarchy is respected automatically.
- Product Badges: No assignment options – these are meant to be assigned directly to products/variations.
Badge Types
| Badge Type | Description | Assignment Method | Priority |
|---|---|---|---|
| New Arrival | Shows on products added within X days | Automatic based on post date | High (1st after variations) |
| Category Badge | Shows on all products in selected categories | Category selection | Medium (4th) |
| Product Badge | Manually assigned to specific products | Product edit page selection | High (2nd) |
| Variation Badge | Specific to product variations | Variation settings | Highest (overrides all) |
Priority System Explained
The plugin uses a smart priority system to determine which badge to show when multiple apply:
- Variation Badge – Highest priority, overrides all others
- New Arrival – Shows if product is within new days threshold
- Product Badge – Manually assigned to specific product
- Category Badge – Based on product categories
- Global Badge – Lowest priority, shows if nothing else matches
Only ONE badge is shown at a time – the highest priority that applies.
How Category Hierarchy Priority Works
The plugin automatically calculates category depth. Deeper (more specific) categories have higher priority:
- Clothing (depth 0, parent category) – lowest priority
- ├── Men’s Clothing (depth 1) – medium priority
- │ ├── Shirts (depth 2) – highest priority
- │ └── Pants (depth 2) – highest priority
- └── Women’s Clothing (depth 1) – medium priority
If a product belongs to multiple categories with the same depth, the numeric priority setting (1-10) determines which badge wins.
Settings
Display Settings
Access via Product Badges → Display Settings
| Setting | Options | Description |
|---|---|---|
| Display in Catalog View | Yes/No | Show badges on shop and category pages |
| Display in Single Product View | Yes/No | Show badges on individual product pages |
| Display on Related Products | Yes/No | Show badges on related, upsells, and cross-sells |
| Data Retention | Keep/Delete | Choose whether to keep data when uninstalling |
Badge Creation Settings
When creating/editing a badge, you’ll find these options:
| Field | Description |
|---|---|
| Badge Type | New Arrival, Category Badge, or Product Badge |
| Assignment | Global (all products) or Specific Categories |
| Category Priority | 1-10 priority for category badges (1 = highest) |
| Preset Images | Choose from 33+ SVG badges |
| Text Color | Customize text color |
| Background Color | Customize background color |
| Badge Text | Custom text (e.g., “NEW”, “SALE”) |
| Padding | Top, Bottom, Left, Right padding in pixels |
| Border Radius | Individual corner radius settings |
| Position | Top and Left position (draggable preview) |
| Opacity | 0-10 opacity setting |
| Custom Image | Upload your own badge image |
Frequently Asked Questions
General Questions
Q: Can I show more than one badge at a time?
A: No, the plugin is designed to show a single, most relevant badge per product to avoid visual clutter and maintain a clean design.
Q: Can I use my own images for badges?
A: Absolutely! You can upload any image (JPG, PNG, GIF, SVG) from your media library, or choose from our 33+ preset SVG badges.
Q: Will this work with my theme?
A: Yes! The plugin automatically detects whether you’re using a classic or block theme (including FSE themes like Twenty Twenty-Four) and loads the appropriate display methods. It works with all popular WooCommerce themes.
Q: How many badges can I create?
A: Unlimited! Create as many badges as you need for new arrivals, categories, products, and variations.
Q: Will this slow down my site?
A: No – the plugin is optimized with caching, minified assets, and conditional loading. It only loads scripts and styles where needed, ensuring minimal performance impact.
Badge Assignment Questions
Q: How do I make a badge appear only on certain categories?
A: Create a Category Badge and select “Specific Categories” in the assignment section. Choose the categories where it should appear from the hierarchical category selector.
Q: How do I assign a badge to a specific variation?
A: Edit the variable product, expand the variation (in the Variations tab), and look for the “Variation Badge” section. Select a badge from the dropdown and save the variation.
Q: How does category hierarchy priority work?
A: The plugin automatically calculates category depth. If a product is in “Clothing → Men’s → Shirts”, a badge assigned to “Shirts” will win over one assigned to “Men’s” or “Clothing”. You can also set numeric priorities (1-10) for category badges.
Q: How do “New Arrival” badges work?
A: They’re based on the product’s post date. You can configure how many days a product is considered “new” (1-90 days) in the badge settings.
Q: Can I make a “SALE” badge?
A: Yes! Create a Product Badge with “SALE” text, customize its colors, or use one of the included preset images that say “SALE”, “PROMO”, or “REDUCED”.
Q: Can badges have different positions per product?
A: Yes! Use product-level badges with custom positions for each product. The position is saved with the product and overrides the default badge position.
Priority & Display Questions
Q: Why is my product showing a Category Badge when I assigned a Product Badge?
A: Check if you checked the “Override all category badges” option when assigning the product badge. If not checked, the priority system determines which badge shows. Also verify if a Variation Badge or New Arrival badge has higher priority.
Q: How do I control which badge shows first?
A: The plugin uses a fixed priority order: Variation Badge (highest) → New Arrival → Product Badge → Category Badge → Global Badge (lowest). For category badges, you can set numeric priorities (1-10) to control which wins when a product belongs to multiple categories.
Q: Why isn’t my badge showing?
A: Check these common issues:
- ✓ Badge is published (not in draft status)
- ✓ Display settings are enabled (Catalog, Single Product, or Related)
- ✓ Product meets badge conditions (e.g., new products for NEW badges)
- ✓ No higher priority badge is showing instead
- ✓ Clear any caching plugins if recently updated
Q: My variation badges aren’t showing. What should I check?
A: Ensure you’ve saved the variation after selecting a badge. Also check that no higher-priority badge (like a product badge) is showing instead. The badge should update instantly when selecting variations on the frontend.
Q: Will badges show on related products, upsells, and cross-sells?
A: Yes, if enabled in Display Settings → “Display on Related Products”. The plugin loads badges via AJAX to maintain performance while ensuring they appear correctly.
Technical Questions
Q: Does it work with HPOS (High-Performance Order Storage)?
A: Yes, the plugin is fully compatible and declared with WooCommerce HPOS.
Q: Can I translate the plugin?
A: Yes! The plugin is fully translatable. A .pot file is included in the /languages folder for easy translation.
Q: Will it work with caching plugins?
A: Yes, the plugin is compatible with popular caching plugins like W3 Total Cache, WP Rocket, LiteSpeed Cache, and others. It includes built-in cache clearing on badge updates.
Q: What happens to my data if I uninstall?
A: You can choose to keep or delete all badge data via the Display Settings → Uninstall Settings section. This includes badges, assignments, and settings.
Q: Does it work with page builders like Elementor or Divi?
A: Yes, the plugin works with all major page builders as it uses standard WooCommerce hooks and filters that page builders respect.
Troubleshooting
| Issue | Solution |
|---|---|
| Badge Not Showing |
|
| Wrong Badge Showing |
|
| Design Not Updating |
|
| Variation Badge Not Updating |
|
| Badge Position Wrong |
|
Changelog
Version 6.0.0 (March 2026)
- Complete code overhaul with modern PHP practices
- Added 30+ new preset badge designs
- Optimized performance with improved caching
- Enhanced block theme compatibility
- Improved variation badge switching
- Added responsive design support
- Enhanced security and sanitization
- Fixed various minor bugs and issues
Support
For support, please contact us through CodeCanyon:
- Author: Gema75
- CodeCanyon Profile: http://codecanyon.net/user/Gema75
- Check that you meet all system requirements
- Ensure WooCommerce is active
- Try disabling other plugins to test for conflicts
- Check your PHP error logs for clues