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

Change badge size

Resize text and image badges for desktop, mobile, product pages, and listing pages.

Use the Size section in the badge editor to resize a badge everywhere or set a different size for each device and page type.

Open the Size section

1

Open Badges & Labels

In Shopify admin, open Sami Product Labels > Badges & Labels.

2

Select a badge

Find the badge you want to resize, then click Edit badge/label in its row.

To resize a new badge instead, click Create badge and choose Text badge or Image badge.

3

Expand Size

In the badge editor, stay on the Design tab, scroll to Size, and expand the section.

Size section in the Design tab of the badge editor
Open a badge, stay on Design, and expand Size.

Use one size on desktop and mobile

Under Responsive size, keep Use same size on desktop and mobile selected when the badge should use one set of dimensions on every device and supported page preview.

  • For a text badge, set Width and Height separately.

  • For an image badge with Lock aspect ratio enabled, use the Size slider or Width field. The height changes automatically to preserve the image proportions.

Use same size on desktop and mobile selected for a text badge
Use one set of dimensions for desktop and mobile.

Customize each device and page type

Select Customize desktop and mobile separately when the badge needs different dimensions in different contexts.

  1. Choose Desktop or Mobile.

  2. Choose Product page size or Listing pages size.

  3. Set the dimensions for that combination.

  4. Repeat for the other device and page combinations as needed.

Selection
Where the size applies

Desktop > Product page size

Product pages on desktop

Desktop > Listing pages size

Listing pages, including collection pages, on desktop

Mobile > Product page size

Product pages on mobile

Mobile > Listing pages size

Listing pages, including collection pages, on mobile

The editor uses the label Listing pages size. Use this tab for collection-page and other product-list previews.

Separate size controls for desktop, mobile, product pages, and listing pages
Select a device and page type, then set the size for that combination.

Choose a size unit

Each dimension can use one of these units:

Unit
Use it when

px

You need an exact dimension in pixels.

%

You want the badge to scale relative to the available product-image area. Preview the result on each page type and device.

For a text badge, Width and Height have their own unit selectors. They do not need to use the same unit.

Adjust text badge size

Text badges provide additional controls below Width and Height:

  • Auto-fit text to badge off — Set Text size as a fixed font size in pixels.

  • Auto-fit text to badge on — The app automatically resizes the text to fit the badge background, and Text size becomes a percentage control.

  • Letter spacing — Increase or reduce the space between characters in pixels.

Turn on Auto-fit text to badge when badge text can change length, such as text that contains {inventory} or another dynamic variable.

Auto-fit text to badge enabled with percentage-based text size
Enable Auto-fit text to badge to keep changing text inside the badge background.

Keep or change an image badge's proportions

For image badges, Lock aspect ratio is enabled by default.

  • Keep it enabled to resize the image with one Size or Width control while preserving the source proportions.

  • Turn it off only when you need to set Width and Height independently. Changing them to a different ratio can stretch or squash the image.

Image badge Size controls with Lock aspect ratio enabled
Keep Lock aspect ratio enabled to resize an image badge without distorting it.

Preview and save

Use the preview toolbar to switch between Product page and Collection page, then check both Desktop view and Mobile view. When the badge looks correct in every required preview, click Save.

Next steps

Last updated

Was this helpful?