Asset Guide

Image ratios, file types and character limitations to help you format the assets for your bot.

Written by Edgar
Updated over a week ago

Text Card

640 character limit
supports UTF-8

Gallery Card

up to 10 items in one card
horizontal image aspect ratio is 1.91:1 or 1920x1080 pixels
Square image aspect ratio is 1:1 or 1000x1000 pixels
item title has an 80 character limit
item subtitle has an 80 character limit
optional buttons are limited to 3 per item

Image Card

jpg, png, gif
for best results keep the number of frames for dynamic GIFs below 75

Video

mp4
max. 25 MB after Facebook's transcoding

Audio

mp3, wav, ogg
max. 25 MB after Facebook's transcoding

Buttons

20 character limit
can link to block, URL, phone number, buy and share functionality

Quick Replies

up to 11 items per quick reply
item title has a 20 character limit
can link to block

Persistent Menu

up to 3 top level menus
menu title has a 30 character limit
can link to block or URL

💡 Important to keep in mind:

The heavier the picture is, the longer it takes to load in Messenger. Something below 500KB should work reasonably quick.
Try to use GIFs below 2-3 MB in size