> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sync templates with Meta

> Bring the WhatsApp templates you already created in Meta into Jelou, without recreating them by hand.

If your WhatsApp Business account in Meta already has templates, you don't need to create them again in Jelou. Syncing brings them in for the channel you choose and makes them available in your template list.

The process runs in the background. You can keep working while it advances and follow it from a banner above the table.

## Before you start

Make sure you meet the following:

* You have the permission to **create templates**.
* Have a connected WhatsApp channel. Test (sandbox) channels don't support syncing.

## Sync your templates

**1. Go to Templates**

Go to `Campaigns` → `Templates`.

**2. Apply the channel filter**

Select the channel you want to sync and **apply the filter**. The sync option is only enabled when the selected channel is the one applied in the table.

**3. Open the Manage templates menu**

When syncing is available to you, the create button in the header becomes a menu with two options:

* **Send template:** opens the usual template creation.
* **Sync with Meta:** starts the sync for the applied channel.

**4. Select Sync with Meta**

Jelou first checks what would change. If there are templates to sync, the process starts right away and **doesn't ask for confirmation**.

If everything is up to date, you will see the message **Your templates are already synced with your provider** and nothing starts.

**5. Follow the progress**

A banner with the progress appears below the header. When it finishes, the table refreshes on its own with the imported templates.

### When the option is disabled

The **Sync with Meta** option is disabled in these cases:

| Situation | What you see | What to do |
| - | - | - |
| A sync is already running | **Sync in progress** | Wait for it to finish |
| The filter channel isn't the applied channel | Option disabled | Apply the channel filter and open the menu again |
| Jelou is calculating the changes | **Syncing with Meta** | Wait a few seconds |

## Statuses and banners

The banner appears below the header and changes according to the sync status:

| Status | What you see |
| - | - |
| Queued | Progress banner: the sync is about to start |
| Importing | **Syncing with Meta** with a progress bar |
| Sending | **Syncing with Meta** with the progress bar of the provider sending phase |
| Waiting | "The provider limited submissions. Resumes at HH:mm". Meta limits how many requests can be made in a period, and Jelou continues on its own once the limit lifts |
| Completed | Success banner: **Sync completed** and how many templates were imported, or "There were no new templates to import" |
| Incomplete | Error banner: **Sync incomplete** with how many templates were imported and how many are pending |

### If the sync is incomplete

The error banner shows how many templates were imported and how many are pending. Click **Show details** to see:

* The cause of the error.
* The imported and pending templates.
* The **Retry** button.

These are the most common causes:

| Cause | What it means |
| - | - |
| The provider limited submissions | Meta limited requests several times in a row |
| The sync was interrupted | The process stopped before finishing |
| The sync couldn't be completed | Any other cause |

> [!NOTE]
>
> If you start the sync and close the screen, the process continues. When you return to **Templates** you will see the banner with the current status.

If an action fails, a message with the reason appears. If none is available, you will see: "We couldn't sync the templates. Try again."

## Templates with an image, video or document

Meta doesn't provide the sample file for templates with an image, video or document header. That's why these templates are imported **without a file** and are marked as **Media file pending**.

If there are such templates, the completed banner flags it with an additional notice and the count.

When you open one of them you will see the message: "This template was imported from your provider without a media file. You can upload it now or when sending the campaign." To upload it now:

**1. Open the template**

Select it in the templates table.

**2. Upload the file**

Click **Upload file** and upload the file. This requires the permission to **edit templates**.

Allowed formats and maximum sizes:

| Type | Formats | Maximum size |
| - | - | - |
| Image | .jpg, .jpeg, .png | 5 MB |
| Video | .mp4 | 15 MB |
| Document | .pdf | 15 MB |

> [!TIP]
>
> The file you upload is used by default when sending the template. **It doesn't change the template in Meta or require a new approval.** To pick good dimensions, check the [media recommendations](https://docs.jelou.ai/en/connect/campaigns/template-dimensions.md).

## Next steps

> [card] [Your first template](https://docs.jelou.ai/en/connect/getting-started/create-your-first-template.md)
>
> Create a template from scratch and submit it for review.

> [card] [Template categorization](https://docs.jelou.ai/en/connect/campaigns/template-categorization.md)
>
> Understand how the category affects pricing and approval.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.