Badgely Documentation

Overview

Eye-catching product badges: automatic Sale %, New, Bestseller, Low stock and Sold out, plus your own badges per product, category or tag.

• Highlight sales, bestsellers and new arrivals
• Real discounts and low stock shown automatically
• Draw attention in shop and category pages

Best for: Stores with large catalogs

Installation

1. Download badgely-product-badges.zip from My account › My plugins or from your order email. Do not unzip it.
2. In WordPress, go to Plugins › Add New Plugin › Upload Plugin, choose the zip and click Install Now, then Activate.
3. Adjust texts, colors and rules in WooCommerce › Product badges.

Requires WordPress 6.0+, PHP 7.4+, WooCommerce 7.0+. Works with any theme, block themes and page builders.

Features

• Automatic badges: Sale with the real discount ("-20%", largest discount for variable products), New (published in the last X days), Bestseller (your top X products), Low stock ("Only 3 left"), Sold out, Featured
• Custom badge per product (text and colors) in Product data › Badge
• Category and tag badges: "Made in France", "Organic", "Vegan"… on every product of a category or tag
• Your texts and colors for every badge, with a live preview
• Pill, rounded or square shape; top left or top right of the image; maximum number of badges per product
• Shop, category pages, product grids (classic and block themes) and product pages
• Replaces the default WooCommerce "Sale!" badge (optional)
• `[badgely]` shortcode for custom templates
• Bestsellers cached for speed; badges are plain HTML and CSS
• Compatible with HPOS
• Lightweight: no jQuery, no external service, no tracking
• Translation-ready

Shortcodes

Paste a shortcode in any page, post, widget or page builder text block.

• [badgely]

Options of each shortcode are described in the Features above and in the plugin settings page.

For developers

Customize the plugin from your theme’s functions.php or a small plugin, without editing its files (your changes survive updates).

Filters

• badgely_badges

add_filter( 'badgely_badges', function ( $value ) {
	// Change $value here.
	return $value;
}, 10, 1 );

Updates

Updates are free. When a new version is out, it appears in Dashboard › Updates of your WordPress site and you can install it in one click, or turn on automatic updates in Plugins. This works for the zip downloaded from your Woo-Plugins account; older copies can be replaced by downloading the latest version from My plugins. See the changelog.

Frequently asked questions