# Images

Adding visible images to an email is possible with Mail Merge for Gmail. There are 3 possibilities: 

* the **image is located on your computer**, read [Insert a local image](#insert-a-local-image)
* the **image is located on your Google Drive**, read [Insert an image from Google Drive™](#insert-an-image-from-google-drive-tm)
* the **image is available through a public URL**, read [Insert a distant image](#insert-a-distant-image)

After being added to the template, you can still edit the image, see Edit an image.

the image size, orientation, and alignment can be edited, just click on the image to display the image toolbox.

## Insert a local image 

You can't directly add a local image to your email, because it has to be accessible online! You can use a hosting service, **but we provide a convenient (and free) solution**: host your images on Google Drive: 

* Go to <https://drive.google.com/drive/my-drive>

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FUEbPfTLnni0yQZWYk5VK%2Fupload%20drive.png?alt=media&#x26;token=3fb9e2df-f4d1-447b-a2ca-7ce3afd0ea4f" alt=""><figcaption><p>Upload a file to Google Drive</p></figcaption></figure>

* Set the permissions to **"Anyone with the link"** / **"Viewer"**. :warning: :warning:Be careful, if you set "Editor", everyone will able to change your image which is probably not something you wish.:warning::warning:

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FNw42oJ6W54N2rtsfrtkc%2Fset%20drive%20permissions.png?alt=media&#x26;token=cd3f1ec8-fc86-4265-aacc-c9133b2daaf8" alt=""><figcaption><p>Upload and set the right level of permissions on your image</p></figcaption></figure>

Then go to the next chapter : ["Insert an image from Google Drive"](#undefined)

## Insert an image from Google Drive™

To add a Google Drive-hosted image to your emails, from the editor click on the Google Drive image icon ![](https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FCfGqPfxdY1cWa79jZGyf%2Fgdrive%20icon.png?alt=media\&token=f9fd1a7c-db0a-403c-9399-6c9b48561e9d). This will open a modal, allowing you to choose your Google Drive image.

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FglIezhttmIZ6KD7SZhf0%2Ffunction%20insert%20Gdrive.png?alt=media&#x26;token=ded78a6f-170f-4302-b5dd-a22c2fae5fd9" alt=""><figcaption><p>Select "Insert image from Google Drive" and pick your picture</p></figcaption></figure>

Before inserting the image in the template, Mail Merge will check permissions on the image. If you have an error message, read the [previous chapter](#insert-a-local-image) to discover how to properly set permissions

&#x20;If you want to change the Alternative Description or Image size, you can now[ edit the image](#undefined) directly from the template.

## Insert a distant image

To add a remote picture to your emails, from the editor click on the image icon ![](https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FsTR4nJG1Y32Hpv4URUw6%2Fremotepiclogo.png?alt=media\&token=8faca042-d9f1-4d3f-9bff-c6d3aeb670bd). This will open a modal, allowing you to insert your picture's "source" URL.&#x20;

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2F53AcTXKkjC86vHCJuAZB%2Ffunction%20remote%20picture.png?alt=media&#x26;token=3cd0d42c-cae0-4a51-8383-82f459f05e46" alt=""><figcaption><p>Click the on function "Insert/edit Image"</p></figcaption></figure>

Optionally, you can add an alternative description and define the size of the image.

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2Fm3mbYmyB21IhbQVgaVMO%2Ffunction%20remote%20picture%20source.png?alt=media&#x26;token=da5abc42-0d42-4926-ac85-4757da50fa01" alt=""><figcaption><p>Insert your image URL in the source field</p></figcaption></figure>

If you want to change the Alternative Description or Image size, you can now[ edit the image](#undefined) directly from the template.

## Edit an image

After being added to the template, the image's size, orientation, and alignment can be edited, just click on the image to display the image toolbox.

<figure><img src="https://3759601264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtBoQpQrzJViUHu4Cv5ai%2Fuploads%2FlyKHSgtRb4goox66TRuJ%2Ffunction%20remote%20edit%20image.png?alt=media&#x26;token=a28e63c7-fbb4-4f47-a539-cde4f08f8baa" alt=""><figcaption><p>Just click on the image to open the image edition toolbox</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.merge.email/support/images.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.