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

Upload your own badge image

Use your own artwork on an image badge by uploading a file from your computer or importing it from a direct image link.

Besides the built-in image library, Sami Product Labels lets you use your own artwork on an image badge. You can upload a file from your computer or import an image from a URL. Uploaded images are saved in your own image list, so you can reuse them on other badges later.

Before you start

Prepare an image that matches the recommendations shown in the badge editor:

Requirement
Recommended value

File formats

PNG, JPG, SVG

Maximum size

5 MB

Dimensions

512 × 512 px

A square PNG with a transparent background looks best, because the badge sits on top of the product image.

Open the image picker

1

Open Badges & Labels

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

2

Create an image badge

Click Create badge, then in Choose badge type click Create on the Image badge card.

To change the image of an existing badge instead, click the pencil icon in that badge's row, then click Change Image in the Content section.

Choose badge type dialog with the Image badge option
Select Image badge to start a badge that uses a graphic.
3

Switch to "Design your Images"

The Select Image panel opens on the right with a default image already applied. Next to Source, click Design your Images.

This tab holds everything that belongs to your store: images you uploaded, images imported from a URL, and AI-generated images. The first two tiles are the actions Upload from URL and Upload image.

Select Image panel with the Library and Design your Images source tabs
Design your Images contains your own artwork, plus the Upload from URL and Upload image actions.

Add your image

Choose the way that fits your artwork.

1

Click "Upload image"

Click the Upload image tile. Your computer's file picker opens.

Upload image tile in the Design your Images tab
Click Upload image to browse files on your computer.
2

Choose the file

Select a PNG, JPG, or SVG file up to 5 MB, then confirm in the file picker. The image is uploaded and appears as a new tile in Design your Images.

3

Apply the image

Click the new tile — a green check mark appears on it and the badge preview updates immediately. Click Select Image at the bottom of the panel to confirm and close it.

Selected image tile with a green check mark and the Select Image button
Click the tile, then click Select Image to apply it to the badge.

Use this when your artwork is already online, for example in your Shopify Content > Files library.

1

Click "Upload from URL"

Click the Upload from URL tile. A small Upload from URL panel opens with the field Paste a direct image link.

Upload from URL panel with the image link field and the Add image button
Paste a direct image link, then click Add image.
2

Paste a link that ends with the image file itself, such as https://example.com/badge.png. A link to a web page that merely shows the image does not work.

To get a direct link from Shopify, go to Content > Files, upload your image, then copy its link.

3

Click "Add image"

The message The image uploaded appears and the image is added to Design your Images as a new tile named Custom Image.

If you see Something went wrong, please try again, the link could not be downloaded — see Troubleshooting below.

Imported image added as a new tile named Custom Image
The imported image is saved to your image list and can be reused later.
4

Apply the image

Click the new tile, then click Select Image. The Content section now shows the image name with the Change Image and Remove actions.

Content section showing the applied custom image with Change Image and Remove
The badge now uses your own image.

Manage your uploaded images

Hover over any tile in Design your Images to reveal two icons:

  • Pencil — rename or edit the image.

  • Trash — delete the image from your list.

You can also click Edit with AI at the bottom of the panel to modify the selected image with the AI editor.

Finish the badge

After the image is applied:

  1. Set the badge size in the Size section — keep Lock aspect ratio ticked so the image is not stretched.

  2. Adjust Position, then set targeting on the Products and Display tabs.

  3. Choose Active or Draft, then click Save.

See Create an image badge for the full set of steps.

Troubleshooting

Problem
What to do

Something went wrong, please try again

The link is not a direct image link, the file is private, or the host blocks other sites from loading its images. Try another host, or download the file and use Upload image instead.

The badge looks blurry

Upload a larger image — around 512 × 512 px — instead of enlarging a small one.

The image has a white box around it

Use a PNG or SVG with a transparent background.

The file is rejected

Check that it is PNG, JPG, or SVG and smaller than 5 MB.

Next steps

Last updated

Was this helpful?