---
title: Placements
slug: q2bg0221
canonical_url: https://docs.coveo.com/en/q2bg0221/
collection: coveo-merchandising-hub
source_format: adoc
---
# Placements
> **Important**
>
> Contact your Coveo representative to enable the Badge manager in your [Coveo organization](https://docs.coveo.com/en/185.md).

The **Placements** tab in the Badge manager lets you create and manage placements that determine where badges appear on your [storefront](https://docs.coveo.com/en/p33g0410.md).
Each placement defines a location on your site (such as [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187.md), search results, or [product detail pages](https://docs.coveo.com/en/n8ad7392.md)) 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](https://docs.coveo.com/en/p33g0410.md) where badges appear.
Your implementation team typically configures placements based on your [storefront](https://docs.coveo.com/en/p33g0410.md) design, ensuring badges fit within the available space and match your visual style.

There are two types of placements:

[%header,cols="3*"]
|===
|Placement type
|How it works
|Examples

|**Linked**
|Badges are embedded in existing Commerce API responses. No additional API call needed.
a| * Product listing pages
* Search page

|**Standalone**
|Badges are fetched via a dedicated endpoint using product IDs.
a| * 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

. In the CMH navigation menu, select **Badges**.

. Select the [property](https://docs.coveo.com/en/p4ue0547.md) and [locale](https://docs.coveo.com/en/p4tf0351.md) you want to manage placements for.

. Click the **Placements** tab.

. Click **Create placement**.

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

.. **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".

.. **Location**: From the dropdown menu, select where this placement will be used on your [storefront](https://docs.coveo.com/en/p33g0410.md).

Available options depend on your implementation and can include:

* [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187.md)

* Search page

* Product detail pages (PDP)

.. **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](#badges-priority-in-placement)) will be displayed.

. Click **Create placement**.

Once created, the placement generates a unique ID that is used to connect your [storefront](https://docs.coveo.com/en/p33g0410.md) 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](https://docs.coveo.com/en/q2bg0220.md).

> **Note**
>
> If you don't configure a placement ID for a category on your [storefront](https://docs.coveo.com/en/p33g0410.md), your site uses the default badge behavior defined in your implementation.

. [[implement-placement-on-your-storefront]]Implement the placement on your [storefront](https://docs.coveo.com/en/p33g0410.md).

Work with your implementation team to integrate the placement ID into your [storefront](https://docs.coveo.com/en/p33g0410.md) code.

> **For developers, implementation depends on the placement type**
>
> * [**Linked placements**](https://docs.coveo.com/en/q2bg0221.md#about-placements) (product listing pages, search results): Badge data is automatically included in product discovery controller responses.
> No additional API calls are needed.
> Display badges from `product.badgePlacements` in your product list components.
> For direct Commerce API usage, see [Retrieve badges for products on linked placements](https://docs.coveo.com/en/p5je0317.md#retrieve-badges-for-products-on-linked-placements).
> 
> * [**Standalone placements**](https://docs.coveo.com/en/q2bg0221.md#about-placements) ([product detail pages (PDPs)](https://docs.coveo.com/en/n8ad7392.md), cart): Requires the `ProductEnrichment` controller (Headless 3.37.0+ for CSR, 3.40.0+ for SSR) or direct Commerce API calls.
> For implementation details, see [client-side rendering (CSR)](https://docs.coveo.com/en/o8ce0239.md#displaying-badges-on-a-product-detail-page), [server-side rendering (SSR)](https://docs.coveo.com/en/oc685393.md#displaying-badges-on-a-product-detail-page), or [direct Commerce API calls](https://docs.coveo.com/en/p5je0317.md#retrieve-badges-for-a-standalone-placement).

## Edit a placement

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

. Click [dots], and then select **Edit**.

. Modify the placement settings:

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

.. [[badges-priority-in-placement]]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](https://docs.coveo.com/en/q2bg0220.md)).

To learn more about how this works, see [How displayed badges are prioritized](https://docs.coveo.com/en/q36b0178.md#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.

. 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](https://docs.coveo.com/en/q2bg0220.md) tab.

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

. Click [dots], and then select **Delete**.

. Confirm the deletion.

The placement is permanently removed from your [property](https://docs.coveo.com/en/p4ue0547.md).

## What's next?

Now that you've created and configured placements, you can [create and manage badges](https://docs.coveo.com/en/q2bg0220.md) and assign them to these placements.