Compress to KB topic guide

Compress images for WhatsApp: hit the 5 MB image message cap

Direct answer

WhatsApp treats a photo sent as an image differently from a file sent as a document. Meta’s WhatsApp Cloud API Image messages docs list JPEG and PNG image messages at a maximum of 5 MB each (8-bit RGB or RGBA). If you need the bytes to travel as a normal image message — not a download-only document — compress to a deliberate budget under that 5 MB ceiling first.

Try the Compress to KB

What this workflow handles

Use the published image-message limit as the hard budget, then leave headroom for mobile networks. Meta’s Image messages page (developers.facebook.com/docs/whatsapp/cloud-api/messages/image-messages/) and the Cloud API Media reference both state JPEG (.jpeg, image/jpeg) and PNG (.png, image/png) max size 5 MB, with images required to be 8-bit RGB or RGBA. The same Media reference separately notes that media message downloads on Cloud API support up to 100 MB before error 131052 — that is a different constraint from the 5 MB image-message send table; do not confuse the two. WhatsApp Help Center’s “How to send media, contacts, or location” article documents a 2 GB maximum for documents on WhatsApp Web/Desktop when you attach a file as a document instead of as Photos & Videos — useful when you must preserve an original that cannot fit under 5 MB as an image. Prefer JPEG for continuous-tone photographs when sending as an image; keep PNG for sharp graphics or required transparency. Enter a target safely under 5120 KB (for example 4000–4800 KB) in Compress to KB, quality-sweep at the original dimensions first, and downscale only if the quality floor still misses the budget. Consumer chat apps may also recompress media after send; the Cloud API 5 MB table is still the clearest published image-message ceiling to aim under before you hit send.

Use Compress to KB with a target under 5120 KB (for example 4000–4800 KB) before you send a WhatsApp image message. For email attachment caps instead, see Compress image for email.

How to use it

  1. Confirm you need an image message (inline photo) rather than a Document file transfer; read Meta’s Image messages 5 MB JPEG/PNG table and WhatsApp Help’s Document option (up to 2 GB) if you need the original.
  2. Convert photographs to JPEG when you are sending as an image; keep PNG only for graphics or required transparency (Cloud API image table lists JPEG and PNG).
  3. Enter a Compress to KB target under 5120 KB (commonly 4000–4800 KB), quality-sweep at the original dimensions first, and allow stepped downscale only if the quality floor still exceeds the budget.
  4. Confirm the output is JPEG or PNG, at or under 5 MB, then send as Photos & Videos / image — not as Document — when you want a normal image message.
  5. If the client still rejects or heavily recompresses the file, lower the KB target further, or switch that file to Document per WhatsApp Help when fidelity matters more than inline preview.

Frequently asked questions

What is WhatsApp’s image file size limit?

For WhatsApp Business Cloud API image messages, Meta’s documentation lists JPEG and PNG at a maximum of 5 MB each. Images must be 8-bit RGB or RGBA. Treat 5 MB (5120 KB) as the hard ceiling for files you intend to send as image messages, and prefer a slightly lower Compress to KB target so encoding and mobile upload headroom remain.

Is the 5 MB limit the same as the 100 MB media limit?

No. The Image messages / Supported media types tables cap JPEG and PNG image payloads at 5 MB. The Cloud API Media reference separately describes a 100 MB maximum for media message downloads, with webhook error 131052 when a customer sends a larger file. Use 5 MB when preparing an image message; do not plan image sends against the 100 MB download figure.

When should I send a photo as a Document instead of compressing?

When you must keep original fidelity and the file will not fit under the 5 MB image-message table after a reasonable quality sweep. WhatsApp Help documents sending files as Document on WhatsApp Web/Desktop with a maximum allowed document size of 2 GB. A document arrives as a file transfer, not a normal inline image preview workflow — compress when you need a regular image message.

What KB target should I use in Compress to KB?

Start from 5120 KB (5 MB) and leave headroom: 4000–4800 KB is a practical per-image target for a single photo image message. If you are bundling several images in a short sequence, keep each under that same ceiling independently — the Cloud API table is per image message, not a shared email-style message total.

JPEG or PNG for WhatsApp image messages?

Meta’s image-message table accepts JPEG and PNG only for those rows. Prefer JPEG for photographs; use PNG when you need sharp edges or transparency. WebP is not listed in that JPEG/PNG image table — if a path only accepts those MIME types, convert before you send.

Will WhatsApp still recompress my photo after I upload?

Consumer WhatsApp clients often recompress media for delivery. Compressing under the published 5 MB image-message ceiling still matters so the upload is accepted as an image and so you control the starting file. For archival originals, use Document (Help Center 2 GB document path) instead of chasing lossless image-message delivery.

How is this different from the email and general KB guides?

compress-image-for-email covers Gmail/Outlook.com 25 MB message attachment caps. compress-image-to-kb covers forms and marketplaces (GOV.UK, LinkedIn, Shopify). This page isolates WhatsApp image-message rules from Meta’s Cloud API docs and the Help Center document path. Same Compress to KB tool; different destination budget.

Sources

Explore the compress to kb topic cluster

This guide covers WhatsApp image-message size. Related guides cover general KB budgets, email attachment caps, and format choice.

Related guides

All compress to kb guides