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) or catalog attributes (such as category or price).

  • 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.

    The product attribute selector is a searchable dropdown that presents two groups: Social-proof counters (such as views, purchases, and add to carts) and Catalog attributes (such as category or price). The group you select the field from determines whether you create a social-proof rule or an attribute-based rule. Every rule uses a field, an operator, and a value.

    Depending on the group you select the field from, follow the matching rule path:

    • Social-proof rule: To badge products based on real-time shopper engagement:

      1. Select a field from the Social-proof group.

      2. Select an operator, and then enter a value.

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

      4. Click Apply.

    • Attribute-based rule: To badge products based on catalog attributes:

      1. Select a field from the Catalog attributes group.

      2. Select an operator, and then enter or select a value. The available operators and the value depend on the catalog field type:

        • String fields: Select from Is, Is not, Contains, Does not contain, Is defined, and Is not defined. The value input suggests catalog values and also accepts custom values. For multi-value string fields, you can select or enter more than one value.

        • Numeric fields: Select from Is, Is not, Is less than, Is less than or equal to, Is greater than, Is greater than or equal to, Is defined, and Is not defined. The value input is a numeric input.

      3. Click Apply.

        Example: Badge products by catalog attribute

        To badge every product in a specific category, select the category String attribute, select the Is operator, and then enter a single value such as Outerwear. Assign the badge to your product listing page placement so it appears on category pages.

  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 Font 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.

      Note

      The Image URL must reference an image hosted externally, such as on a CMS, DAM, or other content repository. Coveo doesn’t host images on customers' behalf.

    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.

For developers: Implementation depends on placement type

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.