> 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/badges-and-labels/create-text-badge.md).

# Create a text badge

Step-by-step guide to creating a text badge with custom text, shape, and colors.

Text badges let you display a custom message on a solid, shape, or image background directly on your product images. Follow these steps to create one in Sami Product Labels.

{% hint style="info" %}
You can also start from a trending template. On the Badges & Labels list page, browse the trending templates section and click one to use it as a starting point. The template pre-fills the text, shape, and colors so you can customize from there.
{% endhint %}

{% stepper %}
{% step %}

## Go to Badges & Labels

In the Sami Product Labels navigation, click **Badges & Labels** to open the badges list page.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-9bd0a0dde3c1d3e45facccd9e130fc9c5dbf92e2%2Fimage_188.png?alt=media" alt="Sidebar with Badges and Labels highlighted"><figcaption><p>Select Badges &#x26; Labels from the sidebar navigation.</p></figcaption></figure>
{% endstep %}

{% step %}

## Start a new badge

If the list is empty, click **Add a new label/badge**. If you already have badges, click **Create badge**.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-6d76efb43d54d741fa188b39333b1820d1986eed%2Fimage_187.png?alt=media" alt="Create button on the badges list page"><figcaption><p>Click Create to start building a new badge.</p></figcaption></figure>
{% endstep %}

{% step %}

## Select "Text badge"

In **Choose badge type**, find **Text badge** and click **Create**.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-7e9c67a4237287359441932152ea3906bff03624%2Fimage_2.png?alt=media" alt="Badge type selection with Text option"><figcaption><p>Choose Text to create a text-based badge.</p></figcaption></figure>
{% endstep %}

{% step %}

## Name the badge

The editor opens with a default name such as **New Badge**. The name field sits in the toolbar above the preview — click it and type a descriptive internal name such as "Summer Sale" or "Low Stock Warning", up to 50 characters. A counter beside the field shows how much you have used. This name never appears on your storefront.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-375b661cb8d5c2b2b7241193efa6b49a7042abae%2Fimage_3.png?alt=media" alt="Badge name input field"><figcaption><p>Enter a descriptive name to identify your badge.</p></figcaption></figure>
{% endstep %}

{% step %}

## Edit text content

Use the rich text editor to write your badge message, with bold, italic, and other styling options.

To show live product data, insert dynamic variables like `{sale}` for the discount percentage or `{inventory}` for the stock count. Variables are replaced with real values on your storefront.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-7223d54626a663b009a999bcedabd7314a2dad8a%2Fimage_4.png?alt=media" alt="Rich text editor with dynamic variable options"><figcaption><p>Write your badge text and insert dynamic variables for live product data.</p></figcaption></figure>
{% endstep %}

{% step %}

## Choose a template background

Under **Fill type**, select **Shape**, then click **Choose from library**. The **Template gallery** includes filters such as Sales, Autotext, Stock, Free shipping, and Pre-order. Choose one template and continue customizing it in the editor.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-d959be365865ed625e3c427e291f01c836cc20eb%2Fimage_5.png?alt=media" alt="Design panel with Choose from library highlighted"><figcaption><p>In Style, click Choose from library to open the Template gallery.</p></figcaption></figure>

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-5da4c0ce3ca1d54348f6802bc33d3bee172ebf6e%2Fimage_9.png?alt=media" alt="Template gallery with badge template filters"><figcaption><p>Browse the Template gallery and select a background preset.</p></figcaption></figure>
{% endstep %}

{% step %}

## Set the background color

For a solid background, select **Solid** and choose its color. For a gradient, select **Shape**, set the **Start color** and **End color**, then choose a **Gradient direction**.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-298fd57f703b899ac691e5fd0647a0c94f379b39%2Fimage_6.png?alt=media" alt="Background color picker with gradient options"><figcaption><p>Set a solid color or gradient for your badge background.</p></figcaption></figure>
{% endstep %}

{% step %}

## Set the text color

Pick a text color that contrasts well with your background color to keep your badge text easy to read.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-19bd1c9bc5db2e1d1e694d6516c9818a26ef70b1%2Fimage_7.png?alt=media" alt="Text color picker"><figcaption><p>Choose a text color that stands out against the background.</p></figcaption></figure>
{% endstep %}

{% step %}

## Choose which products show the badge

Open **Products**, then choose one targeting mode:

* **All products** — Show the badge on every product in your store.
* **Specific products** — Click **Browse**, search or filter your catalog, select the product checkboxes, then click **Select**. You can also use the **Search products** field to find products directly.
* **Products matching conditions** — Click **Add conditions**, create one or more rules, then choose whether products must match **all conditions** or **any condition**.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-42dac26c71a64b7b8df07a543582f2772d8216bf%2Fimage_189.png?alt=media" alt="Products tab showing all products, specific products, and products matching conditions"><figcaption><p>Choose the product scope for your text badge.</p></figcaption></figure>

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-800bb09e82b3f022661ae1e5090f0e948e9f7e1f%2Fimage_190.png?alt=media" alt="Select products dialog with search, filters, and product checkboxes"><figcaption><p>For Specific products, select products from the picker and click Select.</p></figcaption></figure>

{% hint style="info" %}
If you choose **Specific products**, select at least one product. An empty selection does not apply the badge to all products. For more targeting examples, see [Target specific products](/badges-and-labels/target-products.md).
{% endhint %}
{% endstep %}

{% step %}

## Save your badge

Set the status switch above the preview to **Active**, then click **Save** in the top-right corner. Leave it on **Draft** if the badge is not ready for your storefront — it saves without going live.

Customer, page, language, country, device, schedule, and priority settings live on the **Display** tab.

<figure><img src="https://1598842017-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1WRTlT5AcaLSAedbCJyZ%2Fuploads%2Fgit-blob-96d35d65e279c6fc42b88af86b7da69414637e16%2Fimage_8.png?alt=media" alt="Save button on badge editor"><figcaption><p>Click Save to finish creating your text badge.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Next steps

* [Target specific products](/badges-and-labels/target-products.md) — Learn more about manual product selection and condition-based targeting.
* [Use dynamic variables](/badges-and-labels/dynamic-variables.md) — Insert live product data like discount percentages and inventory counts into your badge text.
* [Change badge position](/badges-and-labels/change-position.md) — Move your badge to the exact location you want on the product image.
* [Change badge style](/badges-and-labels/change-style.md) — Customize fonts, opacity, animation, and other visual settings.

{% hint style="success" %}
**Need support?**

If you run into any difficulty while following these steps, contact us at <support@samita.io>.
{% endhint %}


---

# 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/badges-and-labels/create-text-badge.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.