Character Limits WhatsApp

The below documents give an overview of the Character limit for WhatsApp Official & Cloud API

Text Messages

  • Maximum length: 4096 characters

Sticker Messages

  • Cloud API: Static and animated third-party outbound stickers are supported in addition to all types of inbound stickers. A static sticker needs to be 512x512 pixels and cannot exceed 100 KB. An animated sticker must be 512x512 pixels and cannot exceed 500 KB.

  • On-Premises API: Only static third-party outbound stickers are supported in addition to all types of inbound stickers. A static sticker needs to be 512x512 pixels and cannot exceed 100 KB. Animated stickers are not supported.

Supported Media Types

Media

Supported Types

Size Limit

audio

audio/aac, audio/mp4, audio/mpeg, audio/amr, audio/ogg (only opus codecs, base audio/ogg is not supported)

16MB

document

text/plain, application/pdf, application/vnd.ms-powerpoint, application/msword, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.wordprocessingml.document, application/vnd.openxmlformats-officedocument.presentationml.presentation, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

100MB

image

image/jpeg, image/png

Images must be 8-bit, RGB or RGBA

5MB

video

video/mp4, video/3gp

Notes:

  • Only H.264 video codec and AAC audio codec is supported.

  • We support videos with a single audio stream or no audio stream.

16MB

sticker

image/webp

Static stickers: 100KB

Animated stickers: 500K

Interactive Message

  • Text message : Emojis and markdown are supported. Maximum length of message: 1024 characters.

  • Footer Message : Emojis, markdown, and links are supported. Maximum length: 60 characters.

  • Header message : Header can be media or text. For text, Formatting allows emojis, but not markdown. Maximum length: 60 characters.

Quick Reply Button Message

  • title – Button title. It cannot be an empty string and must be unique within the message. Emojis are supported, markdown is not. Maximum length: 20 characters.

  • id – Unique identifier for your button. This ID is returned in the webhook when the button is clicked by the user. Maximum length: 256 characters.

  • Only 3 buttons allowed

List Messages

  • Maximum length of button: 20 characters.

  • Maximum length of section : 24 characters.

  • Limited to 10 rows across all sections.

  • Each row contains:

title – Required. Maximum length: 24 characters.

ID– Required. Maximum length: 200 characters.

Description – Optional. Maximum length: 72 characters.

Reference

On-premises API documentation

https://developers.facebook.com/docs/whatsapp/on-premises/reference/messages/

Cloud API documentation:

https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages

Last updated