Badges

This is for:

Merchandiser
Important

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

Use the Badges tab in the Badge manager to create and manage badges that highlight products based on specific criteria. Creating a badge involves three key elements:

  • Badged products: Define which products receive the badge by setting rules based on social proof metrics (such as views or purchases).

  • Content and styling: Configure the badge appearance, including the text, colors, optional images, and the dynamic metric component that displays real-time product data on your storefront.

  • Placements: Choose where the badge appears on your storefront, such as product listing pages (PLPs), search results, or product detail pages.

To learn more about managing where badges appear on your storefront, see Placements.

Create a badge

  1. In the CMH navigation menu, select Badges.

  2. Select the property and locale you want to manage badges for.

  3. In the Badges tab, click Create badge.

  4. In the Badged products section, define which products will receive the badge:

    1. Select the product attribute to use for the badge rule.

      You can choose from social proof metrics (views, purchases, add to carts).

    2. Choose an operator.

    3. Enter the value that determines when the badge applies.

    4. Select a time range for the social proof metric.

      For example: Badge products with more than 50 views in the last 24 hours.

    5. Click Apply.

  5. In the Content & styling section, configure how the badge appears:

    1. In the Content dropdown, enter the Badge text to display on the badge.

      Note

      You can include a dynamic metric placeholder in your badge text to display real-time product data. When you insert the placeholder, it automatically updates with the actual metric value for each product. Supported metrics are {{purchases}}, {{addToCarts}}, and {{views}}. For example, if you enter "{{purchases}} bought in the last 24 hours", a product with 9 purchases would display a "9 bought in the last 24 hours" badge.

    2. In the Styling dropdown, choose the Background color to match your storefront design.

    3. Choose the Text color for optimal readability against your background.

    4. (Optional) Enter an Image URL to display an image on the left side of the badge text.

      Leave blank if you want a text-only badge.

    5. Click Apply.

  6. In the Placements section, choose where the badge will appear on your storefront:

    Note

    Placements define locations like product listing pages, search page, or product detail pages.

    1. Click Apply.

  7. Click Publish now to make the badge active.

    The badge is immediately available in Commerce API responses and will appear on products that meet its criteria.

Edit a badge

  1. In the Badges tab, locate the badge you want to edit.

  2. Click dots, and then select Edit.

  3. Modify any aspect of the badge:

    • Update the badge rules by changing product attributes, operators, values, or time ranges.

    • Change the badge text or add dynamic metrics.

    • Adjust the badge styling including background color, text color, or image.

    • Select a different placement.

  4. Click Publish now to apply your changes.

Delete a badge

  1. In the Badges tab, locate the badge you want to delete.

  2. Click dots, and then select Delete.

  3. Confirm the deletion.

Warning

Deleting a badge is permanent and can’t be undone. The badge will stop appearing on your storefront immediately.