> For the complete documentation index, see [llms.txt](https://doc.batch.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.batch.com/guides-and-best-practices/message/email/content-and-media/how-to-add-and-edit-images-in-your-email.md).

# How to add and edit images in your email?

Your complete guide to using images in the Email Composer.

Images are essential in your email marketing strategy. They represent your brand and products, and one of the first things that catch the eyes when opening an email. We will see how to manage them to create your email.

## Add images <a href="#h_6ceea5f14b" id="h_6ceea5f14b"></a>

Once you have finished the structure of your email, you can add Blocks to define the content of each part of your email.

### Create the block

Select the block, then choose **Image** or **Banner** from the left side to add it to your email:

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2Fz4RHcIJsI05LJuINMmuo%2FCleanShot%202026-02-13%20at%2014.02.09.gif?alt=media&#x26;token=39500fc6-afb2-4ff4-8a14-5f6e1b1ee35d" alt=""><figcaption></figcaption></figure>

### Link the image <a href="#h_ce3f24f028" id="h_ce3f24f028"></a>

Now, you will be able to attach the image to the **Block**. First, click on the **Image** block to open the settings panel on the right:

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FWHL6zHPnr0LM0u6DyoxB%2FCleanShot%202026-02-13%20at%2014.15.50%402x.png?alt=media&#x26;token=f11a9a56-596e-459c-80a4-9b4295eacb2e" alt=""><figcaption></figcaption></figure>

There are 2 ways to add your image:

* **Upload an image from your computer**

You can then **drag and drop** the image you want to use for your campaign or upload it from your computer by clicking the arrow and selecting the image of your choice on your files.

* **Paste a URL from an external link**

You can use an image URL link that you host on your end. Click **or** **Paste URL** and enter the URL to your image.

{% hint style="warning" %}
If you want to use this image for other campaigns, select the **Download to the gallery** option. Otherwise, choose **Leave as external Link**.
{% endhint %}

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FiUS2mC3KJpr8RdkMuzND%2FCleanShot%202026-02-13%20at%2014.22.03%402x.png?alt=media&#x26;token=63ed5826-41e7-4bce-bd95-e95feb604bd2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**About image compression**

To keep your emails lightweight and protect deliverability, JPEG images uploaded to the Email Composer are automatically compressed (25%). This setting applies to all emails and cannot be disabled.

The following images are not compressed:

* PNG and GIF images
* Images added with an external link (**Leave as external Link**)
* Images auto-filled from a URL

If image sharpness matters (visuals with text, logos, fine details), you can use a PNG file or host the image on your side and add it as an external link.
{% endhint %}

## Edit images <a href="#h_f38212663b" id="h_f38212663b"></a>

Now that your images are in place, you can edit them to make them perfect for your email!

Select your image and, on the settings panel, click on **Edit image** 🪄:

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FTsElijcQjRc7sGh08ojN%2FCleanShot%202026-02-13%20at%2014.25.58%402x.png?alt=media&#x26;token=603fe08a-1f4a-449b-928e-3fcb8f60f82b" alt=""><figcaption></figcaption></figure>

In a new pop-up window, your image will be opened with the Pixie editor where you can do whatever you want!

It is possible to:

* Apply filters
* Resize and crop images
* Draw
* Place text
* Add stickers
* Add frames
* Apply backgrounds
* ...and so much more!

<figure><img src="https://509463063-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfiAYaWDWqtFZeXxyg67F%2Fuploads%2FtYr7zzQ94ZGsL7ISDjqH%2FCleanShot%202026-02-13%20at%2014.32.32%402x.png?alt=media&#x26;token=e36a1fd3-4422-465e-a686-f25f1a98aad7" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Once you've finished editing, do not forget to click on **Save** in the editor window to apply the changes to your image! :sparkles:
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.batch.com/guides-and-best-practices/message/email/content-and-media/how-to-add-and-edit-images-in-your-email.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
