Placements

This is for:

Merchandiser
Important

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

The Placements tab in the Badge manager lets you create and manage placements that determine where badges appear on your storefront. Each placement defines a location on your site (such as product listing pages (PLPs), search results, or product detail pages) and controls how many badges can be displayed and their priority order.

About placements

Badges are organized into placements, which are locations on your storefront where badges appear. Your implementation team typically configures placements based on your storefront design, ensuring badges fit within the available space and match your visual style.

There are two types of placements:

Placement type How it works Examples

Linked

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

  • Product listing pages

  • Search page

Standalone

Badges are fetched via a dedicated endpoint using product IDs.

  • Product detail pages

Each placement defines constraints such as:

  • Maximum number of badges per product: Controls how many badges can appear on a single product at once.

  • Page type: Determines which pages the placement applies to.

Create a placement

  1. In the CMH navigation menu, select Badges.

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

  3. Click the Placements tab.

  4. Click Create placement.

  5. In the Placement configuration section, set the parameters for the placement:

    1. Placement name: Enter a descriptive name for the placement.

      Choose a name that clearly identifies the location, such as "PLP product cards" or "Search results badges".

    2. Location: From the dropdown menu, select where this placement will be used on your storefront.

      Available options depend on your implementation and can include:

    3. Max visible badges: Enter the number of badges that can be displayed on a single product at once.

      If a product qualifies for more badges than this limit, only the highest-priority badges (based on the priority order you define) will be displayed.

  6. Click Create placement.

    Once created, the placement generates a unique ID that is used to connect your storefront to this placement. You can copy this ID at any time. It’s not necessary to copy it immediately, as you can always return to the placement details later. The placement becomes immediately available when creating or editing badges.

    Note

    If you don’t configure a placement ID for a category on your storefront, your site uses the default badge behavior defined in your implementation.

  7. Implement the placement on your storefront.

    Work with your implementation team to integrate the placement ID into your storefront code.

Edit a placement

  1. In the Placements tab, locate the placement you want to edit.

  2. Click dots, and then select Edit.

  3. Modify the placement settings:

    1. Update the placement name or maximum badges per product as needed.

      Note

      The Location can’t be changed after a placement is created. To use a different location, delete this placement and create a new one.

    2. In the Badges priority in placement section, define which badges have priority when a product qualifies for multiple badges (this section will be empty until badges are assigned to the placement, see Badges).

      To learn more about how this works, see How displayed badges are prioritized.

      To set the priority order, drag badges to reorder them. Badges at the top of the list have the highest priority.

      • When a product matches multiple badges, the Badge manager displays badges in this order until the maximum badges per product limit is reached.

      • If the highest-priority badge doesn’t apply to a given product, the system automatically falls back to the next eligible badge in the list.

  4. Click Apply to save your changes.

Delete a placement

Important

A placement can’t be deleted while badges are assigned to it. Before deleting a placement, you must first reassign or delete all badges associated with it in the Badges tab.

  1. In the Placements tab, locate the placement you want to delete.

  2. Click dots, and then select Delete.

  3. Confirm the deletion.

    The placement is permanently removed from your property.

What’s next?

Now that you’ve created and configured placements, you can create and manage badges and assign them to these placements.