Upload and reuse media

A shared library for the images, videos and documents you send. Upload once, use anywhere — template headers, broadcast headers, and attachments in Chatbox.

Steps

  1. In the sidebar, open Channels → WhatsApp → Media.

    The Wap2b sidebar with Channels, WhatsApp and Media highlighted
    The library is shared across every number on your account.
  2. Click Upload and pick your files. New folder beside it keeps a large library sorted.

    The Media manager with the Upload and New folder buttons, a search box, and filters for images, videos, audio and documents
    The All / Images / Videos / Audio / Docs filters narrow a full library quickly.
  3. Use them: anywhere Wap2b asks for a picture or document you can pick from the library instead of uploading again.

    The Media manager showing one uploaded video file with its name and size
    Each file shows its size — the number to check against the limits below.

What WhatsApp accepts

These are WhatsApp's limits, not ours. A file outside them is refused at send time even if it uploads fine.

TypeFormatsMaximum size
ImageJPEG, PNG5 MB
VideoMP4, 3GPP16 MB
AudioAAC, AMR, MP3, MP4 audio, OGG16 MB
DocumentPDF, Word, Excel, PowerPoint, plain text100 MB

No HEIC, no WebP

Photos straight off an iPhone are usually HEIC and will not send. Export as JPEG first. WebP images from a website are also rejected.

Getting images right

  • Compress before uploading. A 4 MB photo squeezes under the limit but is slow on a phone with poor signal. Under 1 MB is a good target.
  • Landscape works best for template headers. Portrait images get cropped in ways you cannot control.
  • Keep text out of the image. It cannot be resized, translated or read by a screen reader, and it is the first thing to become unreadable on a small screen. Put the words in the message body.

Documents

The filename is what the customer sees before they open it. invoice-10428.pdf is useful; Scan_20260721_final_v3(2).pdf is not. Rename before uploading.

Where media is used

  • Template headers. You upload a sample when creating the template; the real file is chosen per send. See Create and submit a template.
  • Broadcast headers. If your template has a media header, each broadcast picks the actual file. See Send your first broadcast.
  • Chatbox attachments. Inside an open 24-hour window you can send any supported file directly.

If something goes wrong

  • "Unsupported file type". Check the table above. HEIC and WebP are the usual culprits.
  • It uploaded but will not send. Almost always size. The library accepts more generously than WhatsApp delivers.
  • The image looks wrong in the message. Aspect ratio. Try a landscape crop.
  • A file you deleted is still on old messages. Messages already delivered are not affected — they were sent to WhatsApp at the time.

Next

Collect information with a Flow.

Still stuck?

If this page did not solve it, tell us what you were trying to do and we will pick it up from there.

Open a support ticket