> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.boxiapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# How to Optimize Charm Images for the Builder? (Manually)

A **custom image** is an image specially prepared for the Charmi builder. It allows you to optimize how your products look in the builder without changing the original product images in your store.

**Why is this important?**

If an image has a background or incorrect proportions, it can break the visual experience in the builder and make the design look inconsistent.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/screenshot-2026-04-14-182048_15wqr3c.png =1000x636)
---


**Option 1: Add a Custom Image for the Builder**

Follow these steps to upload a properly optimized image:

1. **Open the Builder Editor**

Click on the **three dots** and select **Edit builder**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/edit-builder_1cf6vzs.png =1000x668)

2. **Open Your Component Collection**

Find your component collection and open it.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/screenshot-2026-04-14-0931372_1eymupx.png =1000x791)

3. **Select a Product**

Locate the product you want to edit (for example, a product with multiple variants) and open it.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/charmi-product_1jourvn.png =1000x1091)

4. **Choose a Variant**

Click on the specific variant that needs a custom image.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/variant-black-background_1chu3v4.png =1000x1774)

5. **Upload a Custom Image**

Scroll down to Metafields and click **View all**.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/product-variant_11qpn6r.png =1000x1168)

Find the Charmi image metafield (in the unpinned section) and click **Select images**

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/charmi-select-images_1j3di8i.png =1000x783)

Upload an image with a transparent background and click **Done**

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/charmi-image_10bgug.png =1000x996)

6. **Save Your Changes**

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/charmi-save-image_1r2hcn6.png =1000x821)

**Result**

Even though your original product image remains unchanged (e.g., with a black background), the builder will now display the optimized version.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/screenshot-2026-04-14-182307_1dzvfvy.png =1000x621)

**Option 2: Shopify Media Editor**

💡 Alternatively, instead of uploading a new image, by clicking on the image you can edit the original image directly in Shopify’s image editor and then assign the edited version to the Charmi image metafield.

**Step 1: Remove the background manually**

1. Open Charmi image and click **Color background**

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/screenshot-2026-07-08-102431_w6jiqt.png =1000x487)

2. Select transparent option
3. Click **Save**

**Step 2: Adjust the image position**

To do so, we need to crop the image.

1. Open the product and click the Charmi image

| Open the correctly aligned charm in a separate tab. This makes comparing positioning much easier.

2. Click **Crop & transform** - select **Square** if your charm images are a square form. This way the charms will look nice in the grid. Or select **Freeform** to trim each side of the image differently.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/7/a/6/37a622ee17372e00/screenshot-2026-07-08-151928_1e7s0z5.png =1000x519)

3. Click **Apply** and **Save**. 

| Crop some empty space from the top so the charm sits closer to the bracelet.
| Crop the left and right sides if the charm is small, making it occupy more of the image.


✅ Tips for Best Results
* Use PNG images with transparent backgrounds
* Keep consistent size and proportions across components
* Center the product in the image
* If the Shopify background remover does not work well, please try https://www.remove.bg/