Browse documentation

WhatsApp services

Media library

Upload and reuse images, videos, documents, and audio in workflows and scheduled messages.

Business usersAutomation buildersBeginnerAvailable

What this guide covers

  • Media stores reusable files for workflow and Scheduler configuration.
  • Prerequisites: A supported file and enough storage entitlement.
  • Result: The file card shows its name, size, date, type, optional tag, and view action.
  • Limit: Deleting a file is irreversible in the UI and may break configurations that still reference its URL or record.

What this is and when to use it

Media stores reusable files for workflow and Scheduler configuration.

When to use Media library
Use it whenExpected outcome
You need a stable asset for Send Media.The file card shows its name, size, date, type, optional tag, and view action.
You want to reuse the same file across schedules or workflows.The file card shows its name, size, date, type, optional tag, and view action.

Before you begin

  1. A supported file and enough storage entitlement.
  2. Maximum sizes: image 5 MB, video 50 MB, document 20 MB, audio 10 MB.

Complete the task

  1. Open Agent Project → Media.
  2. Choose image, video, document, or audio.
  3. Optionally add a tag, select the file, and upload.
  4. Filter the library by type and preview the resulting asset.
  5. Select library as the source in a supported message configuration.

Confirm it worked

  1. The file card shows its name, size, date, type, optional tag, and view action.

Common problems

Media library troubleshooting
SymptomWhat to check
File too largeReduce it below the exact limit for its selected type.
Upload failsConfirm the chosen type matches the file and retry after checking the network.

Current limitations

Deleting a file is irreversible in the UI and may break configurations that still reference its URL or record.

Where to go next