> 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-label-group.md).

# Create a label group

Bundle several labels into one group that sits on top of the product image.

Choose **Inside product image** when the group should overlay the product photo — the usual choice for "Sale", "New", or "Best seller" labels stacked in a corner of the image.

{% hint style="info" %}
Create your labels first in [Badges & Labels](/badges-and-labels/overview.md). The group only bundles labels 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.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-ae09b169300b65f5fb270dd16ca66781ad8a6402%2Fimage_112.png?alt=media" alt="Badge groups empty state"><figcaption><p>Click Create badge group to open the group editor.</p></figcaption></figure>
{% endstep %}

{% step %}

### Select Inside product image

At the top of the **Design** tab, pick **Inside product image**. The group will be positioned over the product photo.
{% 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 "Summer sale labels".
{% endstep %}

{% step %}

### Add labels to the group

In **Label Selection**, click **Add labels to group**. Search by name, tick the labels 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-5d4e876609996e29e9cef9d8b09dd7f6c955ea0a%2Fimage_110.png?alt=media" alt="Add labels to group dialog"><figcaption><p>Tick each label to include, then click Select.</p></figcaption></figure>
{% endstep %}

{% step %}

### Design the group

Open the **Design** section and set how the labels look together:

| Setting                 | What it controls                                                         |
| ----------------------- | ------------------------------------------------------------------------ |
| **Select layout**       | **Horizontal** or **Vertical** stacking.                                 |
| **Item size**           | The size of each label, as a percentage or a fixed value.                |
| **Label gap**           | The spacing between labels, in pixels.                                   |
| **Predefined position** | One of nine anchor points on the product image (corners, edges, center). |
| **Margin**              | Top, bottom, left, and right offset from the anchor.                     |

Check the live preview on the right while you adjust. Use the **Product page / Collection page** menu and the desktop/mobile icons to see the group in each context.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-36db423bfd0d30e0ba120f18ceee5f4237a2f289%2Fimage_113.png?alt=media" alt="Design section with layout, size, gap, and the nine-point position grid"><figcaption><p>The nine-point grid anchors the whole group on the product image.</p></figcaption></figure>
{% endstep %}

{% step %}

### Add custom CSS (optional)

Expand **Advance Section** to add your own CSS for the group. Skip this unless you need styling the settings above can't produce.
{% endstep %}

{% step %}

### Choose how the group is targeted

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

| Option                               | Behavior                                                                 |
| ------------------------------------ | ------------------------------------------------------------------------ |
| **Keep individual label conditions** | Each label 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" %}
FREE and GOLD plans allow 1 label group; deleted groups still count toward the limit. Upgrade to DIAMOND for unlimited groups.
{% endhint %}

## Next steps

* [Create a badge group (outside product image)](/badge-groups/create-badge-group.md) — place a group beside the product information instead.
* [Badge groups overview](/badge-groups/overview.md) — what every setting in the editor does.
* [Target products](/badges-and-labels/target-products.md) — how conditions work for individual labels.


---

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