MMS sizes and limitations
Messages parts and message sizes
MMS is never segmented or broken up into parts, and they do not have catheter limits as SMS. However, MMS and their media files are subjected to size limitations that vary according to the receiving country and networks.
The information below is intended to ensure deliverability across all supported networks in both the USA and Canada. You may be able, on specific networks, to terminate bigger messages but that is not guaranteed
Limitations
- An MMS message can carry up to 10 media attachments
- MMS media URL should be publicly accessible and respond within 5 seconds
- The total maximum file size of an MMS, including all its media attachments, is 900 KB
- The maximum file size (after re-sizing, see below) for any given attachment is 600 KB
- Only certain file types are accepted (see a full list below)
Resizing
Bird CRM supports resizing images and gifs, if you submit a file that is too big (up to 5 MB), we will try to reduce its size to ensure it can be delivered
Re-sizing is a best-effort attempt at striking a balance between quality and size.
Sometimes, it may fail to reduce the size of media to a level that all carriers can accept, and sometimes, it may impact the file quality.
We suggest that you only submit supported files to maintain control of your attachment quality and size.
Supported media types
| Media | Type |
|---|---|
| Audio | <p>audio/basic</p><p>audio/L24</p><p>audio/mp4</p><p>audio/mpeg</p><p>audio/ogg</p><p>audio/vorbis</p><p>audio/vnd.rn-realaudio</p><p>audio/vnd.wave</p><p>audio/3gpp</p><p>audio/3gpp2</p><p>audio/ac3</p><p>audio/vnd.wave</p><p>audio/webm</p><p>audio/amr-nb</p><p>audio/amr</p> |
| Video | <p>video/mpeg</p><p>video/mp4</p><p>video/quicktime</p><p>video/webm</p><p>video/3gpp</p><p>video/3gpp2</p><p>video/3gpp-tt</p><p>video/H261</p><p>video/H263</p><p>video/H263-1998</p><p>video/H263-2000</p><p>video/H264</p> |
| Image | <p>image/jpeg</p><p>image/gif</p><p>image/png</p><p>image/bmp</p> |
| Text | <p>text/vcard</p><p>text/csv</p><p>text/rtf</p><p>text/richtext</p><p>text/calendar</p> |
\
Troubleshooting
Failure related to an attachment can be reconciled by specific error or failure codes, which you can identify in your logs.
All messages failed because the attachment will record a UNSUPPORTED_MEDIA_TYPE: 14004 You can refer to our API documentation for a full list of possible MMS attachments that can help you identify the exact file that caused the issue.
Fallback
Bird only supports MMS delivery to the United States of America and Canada. When attempting to send MMS to any other country, you can control how your channel will behave by using the MMS fallback toggle. If enabled, fallback will convert MMS to regular messages, which will include a URL to the original content. Fallback SMS are charged as short messages and not as media.
US or Canadian receivers without MMS support
Sending an MMS to an American or Canadian number that does not support MMS will result in the message failing. Fallback to SMS will never be attempted, even if the toggle is active, towards any USA or Canada receiver.
