> For the complete documentation index, see [llms.txt](https://docs.mercuri.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mercuri.cx/features/templates/whatsapp-templates/how-to-set-up-media-headers-when-sending-messages-using-the-mercuri-api/how-to-set-up-an-image-header-correctly.md).

# How to Set Up an Image Header Correctly

### What is an Image Header?

An **image header** allows you to display an image (banner, product visual, promotion creative, etc.) **at the top of a WhatsApp message**.

This is commonly used for branding, promotions, announcements, and visual context before the message body.

***

#### Steps:

When creating a WhatsApp template and choosing the **Header** as **Media** type, follow the steps below to successfully pass the correct image during the API call:

<figure><img src="/files/fhUGsjzM1pZeQJzPPhfc" alt="" width="561"><figcaption></figcaption></figure>

1. From the **Header** drop-down, select **Media**, then choose **Image** as the media type.
2. Set the **Type** to **Dynamic**. Only **Dynamic** headers can accept images sent via the Mercuri API.
3. In the **Value** field, enter a variable name (for example: `image`).
4. In the **Sample Value** field, upload a sample image (`.jpg` or `.png`).\
   This image is used **only for preview and template approval** and will **not** be sent to users.
5. Complete and submit the WhatsApp template for approval.
6. **Once the template is approved**, update your **Mercuri API payload** by adding the required details, such as the **template ID**.\
   Ensure the **same variable name** used in the template is passed again in the API parameters.

> {\
> "**parameters**": {\
> "**image"**: "<https://your-storage.com/promo\\_banner.png"\\>
> }\
> }

7. When sending the message using the Mercuri API, pass the **image as a publicly accessible URL**, not as a private or auto-download link.

Following the steps above ensures that the **correct image** is picked up from the Mercuri API and rendered properly in the message header.