For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create an image badge

Step-by-step guide to creating an image badge using the library, your own upload, or AI generation.

Image badges display a graphic on your product images instead of text. Pick from a library of pre-designed badges, upload your own image, or generate one with AI.

1

Go to Badges & Labels

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

Sidebar with Badges and Labels highlighted
Select Badges & Labels from the sidebar navigation.
2

Start a new badge

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

Create button on the badges list page
Click Create to start building a new badge.
3

Select "Image badge"

In Choose badge type, find Image badge and click Create.

Badge type selection with Image option
Choose Image to create an image-based badge.
4

Choose an image

The Select Image dialog lets you choose, upload, or import a badge image:

Browse the image library

Use Library to browse pre-designed images. Search by name, filter by image type, category, or color, and change the sort order. Select an image, then click Select Image to apply it to the badge.

Upload your own image

Open Design your Images to use your own artwork: click Upload image to pick a file from your computer, or Upload from URL to import a direct image link. The editor recommends PNG, JPG, or SVG files up to 5 MB and 512 × 512 px. A transparent PNG usually works best on product images. See Upload your own badge image for the detailed steps.

Create or reuse an AI image

Use Create AI Image to generate a new badge image or View AI images to reuse an existing result. The usage counter shown beside AI Badge Generator reflects the allowance for the current store.

Selected badge image with Create AI Image, View AI images, Change Image, and Remove controls
Manage the selected image or open the AI image tools from the Content section.
Select Image dialog with Library and Design your Images sources
Search the library or open Design your Images to use your own artwork.
5

Adjust the size

Use the Size slider or Width field, then choose px or %. Keep Lock aspect ratio enabled to preserve the image proportions.

Image badge size controls with Lock aspect ratio enabled
Adjust the image width and keep the aspect ratio locked to avoid distortion.
6

Set the badge position

Expand Position, then choose Inside product image or Outside product image.

For an image overlay, keep Inside product image selected and choose one of the nine preset positions. Use Badge placement to apply the same position to collection and product pages, or configure each page type separately. Enable Use Custom Position or adjust Margin and Padding when you need finer control.

Image badge Position section with placement options and the nine-position grid
Choose where the image badge appears and whether collection and product pages share the same position.
7

Choose which products show the badge

Open Products, then choose one targeting mode:

  • All products — Show the image badge on every product.

  • Specific products — Click Browse, select the product checkboxes, then click Select.

  • Products matching conditions — Click Add conditions, create one or more rules, then choose whether products must match all conditions or any condition.

Products tab showing All products, Specific products, and Products matching conditions
Choose the products that should display the image badge.

If you choose Specific products, select at least one product. An empty selection does not apply the badge to all products. See Target specific products for more examples.

8

Configure display conditions

Open Display to control when and where the badge appears. Configure customer and page conditions, language or country restrictions, device and product-image settings under Other conditions, a visibility schedule, and priority when multiple badges target the same product.

Leave a section unchanged when you do not need that restriction.

Display tab with customer, page, language, country, visibility, and priority conditions
Use Display conditions only when the badge needs additional audience, page, device, schedule, or priority restrictions.
9

Save your badge

Review the preview, then choose Active to publish the badge or Draft to keep it hidden from the storefront. Click Save to finish creating the badge.

Save button on badge editor
Click Save to finish creating your image badge.

Next steps

Last updated

Was this helpful?