Badge manager

This is for:

Merchandiser
Important

Contact your Coveo representative to enable the Badge manager in your Coveo organization.

The Badge manager in the Coveo Merchandising Hub (CMH) lets you highlight products with contextual messages that influence shopper behavior. You define badge rules, assign them to placements across your storefront, and control which badges appear and when. Nothing reaches shoppers until you publish.

Why use product badges?

Badges show relevant product context right in the shopping flow. They help shoppers notice important products and understand why they’re worth considering.

Common use cases:

  • Social-proof: "25 bought in the last 24 hours" or "Trending" signals that drive urgency.

  • Product attributes: "New Arrival", "Award-Winning", or "On Sale" labels that surface catalog properties.

  • Scarcity: "Low Stock" or "Only 3 left" messages that encourage faster conversion.

In historical analyses, social-proof badges have consistently driven revenue per visitor uplift. By managing badges directly in the CMH, you can create and update them without developer support and deploy changes immediately.

Prerequisites

To use the Badge manager, you need:

What you can do with the Badge manager

The Badge manager provides comprehensive control over when, where, and how badges appear on your storefront. You can define badge rules to target specific products, customize their appearance and content, and manage their display priority to ensure the most impactful messages reach shoppers.

Define badge rules

Each badge is powered by one or more rules that determine which products qualify. You can create:

  • Attribute-based rules that target products based on catalog information. For example, you can badge products that have a discount, or products marked as "New".

  • Social-proof rules that target products based on real-time shopper engagement. You can select an engagement attribute (views, add to carts, or purchases), choose a time window (in the last hour, last 24 hours, last 48 hours, last 3 days, or last week), and set a threshold. For example, show a "Popular" badge on products with more than 50 views in the last 24 hours.

  • Multi-condition rules that combine attribute-based and social proof conditions using and logic. For example, badge products that are on sale and have been purchased more than 25 times in the last week.

Content and style

For each badge, you configure:

  • Badge text with support for dynamic tokens that insert real values (for example, "9 bought in the last 24 hours").

  • Colors for background and font to match your storefront design.

  • Image URL to display an icon alongside or instead of text.

  • Localized variants so badge copy is accurate for each locale.

Control priority and fallback

Within each placement, you order your badges into a priority cascade. If the highest-priority badge doesn’t apply to a given product, the system falls back to the next eligible badge. This increases badge coverage across a listing while keeping the most important messages visible.

How badges reach your storefront

Badges are organized into placements, which are locations on your storefront where badges appear.

Placement type How it works Examples

Linked

Badges are embedded in existing Commerce API responses. No additional API call needed.

  • Product listing pages

  • Search results

Standalone

Badges are fetched via a dedicated endpoint using product IDs.

  • Product detail pages

  • Cart

Each placement defines constraints such as the maximum number of badges per product and the maximum badge text length. These are typically configured by your implementation team and ensure badges fit within your storefront design.

Once a badge is published in CMH, it’s immediately available in Commerce API responses. Your development team uses Coveo Headless controllers or Atomic components to render badges on the storefront.