# Media Templates

## Overview

A **Media Template** is a pre-approved message format in WhatsApp Business API that allows businesses to send messages with **media content** such as images, videos, or documents along with text. It is used to initiate conversations or send messages outside the 24-hour customer service window.

### Key Features

* **Supports Media Content**\
  Media templates allow inclusion of:
  * Images
  * Videos
  * Documents (PDF, etc.)
* **Header-Based Media**\
  Media is added in the **header section** of the template.

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2FAZsbQmn3ELDGvkSh7Zrv%2Fmedia_template01.jpg?alt=media&#x26;token=39467ed9-9649-4cba-9081-1b51f4824c38" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3382165395-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LlJChpzcxtwOYGcBd1q%2Fuploads%2F8EMTFZjADWJqRlYr5Ob3%2Fmedia_template02.jpg?alt=media&#x26;token=1bb4d52f-de89-4cc9-ba4e-a716f301f3b6" alt=""><figcaption></figcaption></figure>

### Supported Media Types

| Media Type | Description                        |
| ---------- | ---------------------------------- |
| Image      | JPG, PNG formats                   |
| Video      | MP4 format                         |
| Document   | PDF and supported document formats |

#### Template Structure

A standard media template consists of:

1. **Header (Media Section)**\
   Contains the media file (image, video, or document)
2. **Body (Message Content)**\
   Text message with optional variables
3. **Footer (Optional)**\
   Additional short text (e.g., disclaimers)
4. **Buttons (Optional)**\
   Quick Reply or Call-To-Action buttons

#### Use Cases

* Product promotions with images
* Invoice or report sharing (PDF)
* Event invitations with visuals
* Video-based marketing campaigns

| Media Type  | Max Size |
| ----------- | -------- |
| 🖼️ Image   | 5 MB     |
| 🎥 Video    | 16 MB    |
| 📄 Document | 20 MB    |
