> For the complete documentation index, see [llms.txt](https://docs.samita.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.samita.io/badge-groups/create-badge-group.md).

# Create a badge group

Bundle several badges into one group placed next to the product information, outside the product image.

Choose **Outside product image** when the group should sit in the product information column — below the price, under the add-to-cart button, and so on — instead of overlaying the photo. This suits trust and shipping badges that belong with the buying details.

{% hint style="info" %}
Create your badges first in [Badges & Labels](/badges-and-labels/overview.md). The group only bundles badges that already exist.
{% endhint %}

{% stepper %}
{% step %}

### Open Badge groups

In your Shopify admin, open **Sami Product Labels** and click **Badge groups** in the app sidebar.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-9aa805e5b05f7596cb789d7538079e96f018cd75%2Fimage_106.png?alt=media" alt="App sidebar with Badge groups selected"><figcaption><p>Badge groups sits between Badges &#x26; Labels and Extra Features in the sidebar.</p></figcaption></figure>
{% endstep %}

{% step %}

### Click Create badge group

On an empty store you'll see **Create your first badge group**. Click **Create badge group** to open the editor.
{% endstep %}

{% step %}

### Select Outside product image

At the top of the **Design** tab, pick **Outside product image**. The Label Selection button changes to **Add badges to group**, and a **Badge group replacement** menu appears in the Design section.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-a5ea3d83528e4ceda27c21f49ca8c1689ce386ff%2Fimage_114.png?alt=media" alt="Outside product image option selected"><figcaption><p>Outside product image places the group in the product information column.</p></figcaption></figure>
{% endstep %}

{% step %}

### Name the group

The group is called **Label group** by default. Open the **…** menu above the preview, click **Rename**, and type a name of up to 50 characters — for example "Checkout trust badges".
{% endstep %}

{% step %}

### Add badges to the group

In **Label Selection**, click **Add badges to group**. Search by name, tick the badges you want, then click **Select**.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-19af2742489844431672adce18ef17514c14bfb1%2Fimage_116.png?alt=media" alt="Add badges to group dialog"><figcaption><p>Tick each badge to include, then click Select.</p></figcaption></figure>
{% endstep %}

{% step %}

### Choose where the group appears on the page

In the **Design** section, open **Badge group replacement** and pick the product-page element the group attaches to. The default is **Below the product price**; the menu offers the same anchors used for individual badges — see [Change badge position](/badges-and-labels/change-position.md) for the full list.

Then use **Predefined position** to align the group **left**, **center**, or **right** within that element.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-3fbd1a90d5502dcf42348adeae3293b0a37f44d6%2Fimage_117.png?alt=media" alt="Badge group replacement menu and left/center/right alignment"><figcaption><p>Pick a product-page element, then align the group within it.</p></figcaption></figure>
{% endstep %}

{% step %}

### Design the group

Set how the badges sit together:

| Setting           | What it controls                                                  |
| ----------------- | ----------------------------------------------------------------- |
| **Select layout** | **Horizontal** or **Vertical** stacking.                          |
| **Item size**     | The size of each badge, as a percentage or a fixed value.         |
| **Label gap**     | The spacing between badges, in pixels.                            |
| **Margin**        | Top, bottom, left, and right offset from the surrounding content. |

Check the live preview on the right. Use the **Product page / Collection page** menu and the desktop/mobile icons to confirm the group lands where you expect in each context.
{% endstep %}

{% step %}

### Add custom CSS (optional)

Expand **Advance Section** to add your own CSS — useful when a theme's spacing around the chosen element needs a small adjustment.
{% endstep %}

{% step %}

### Choose how the group is targeted

Switch to the **Placement** tab and pick a **Condition type**:

| Option                               | Behavior                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------ |
| **Keep individual badge conditions** | Each badge is shown or hidden by its own targeting rules.                |
| **Set a custom group condition**     | Ignores the individual rules and uses one condition for the whole group. |

Choosing the second option reveals **Product**, **Customer**, **Page**, **Language**, **Country**, and **Other** conditions for the group — see [Set up group conditions](/badge-groups/set-group-conditions.md).

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-0bc46f6027a09a3dc2477cfdc61f1de65194b416%2Fimage_108.png?alt=media" alt="Placement tab with the two condition types"><figcaption><p>Use a custom group condition when the whole set should follow one rule.</p></figcaption></figure>
{% endstep %}

{% step %}

### Save the group

Click **Save** in the top-right corner. The group appears on matching product pages immediately.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
If the group doesn't appear where you expect, your theme may not expose the element you chose. Try a different **Badge group replacement** option, or use a theme selector as described in [Change badge position](/badges-and-labels/change-position.md).
{% endhint %}

## Next steps

* [Create a label group (inside product image)](/badge-groups/create-label-group.md) — overlay a group on the product photo instead.
* [Badge groups overview](/badge-groups/overview.md) — what every setting in the editor does.
* [Change badge position](/badges-and-labels/change-position.md) — the full list of product-page anchors.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.samita.io/badge-groups/create-badge-group.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.