Twilio Programmable SMS Supported File Types and Size Limits for MMS Media Messages

Twilio Programmable SMS supports sending picture messages (AKA MMS or multimedia messages) by adding the MediaUrl parameter to your API request. Continue reading for more details on the supported file types, and attachment file size limitations.

For help with sending MMS messages, please see Simple Example for Sending Programmable SMS Text or Picture Messages.

Supported File Types

Twilio Programmable SMS supports MediaUrl attachments with the following image file formats:

  • jpeg
  • png
  • gif

These image file types are fully supported by Twilio, and will be formatted for delivery on destination devices.

Twilio accepts a number of additional file formats as MediaUrl attachments, but these file types are not formatted for destination device compatibility. For a full list of media formats accepted by the Twilio API, please see Accepted Content Types for Media (Twilio Docs)

File Size Limitations (for non-image files)

For file types other than jpeg, png and gif, the file size limit for MediaUrl attachments depends on the receiving carrier. Here are the attachment size limitations for the top 4 US-based carriers:

Carrier MMS attachment size
AT&T 1.4 MB
Sprint 1.4 MB
T-mobile 0.675 MB
Verizon 0.675 MB

For other MMS-supported carriers, we recommend using attachments no larger than 600KB when sending files that are not jpeg, png, or gif images.

Twilio File Transcoding

Twilio will automatically transcode image file attachments in one of the supported file formats (jpeg, png, and gif). We will not transcode or resize any other types of media.

To ensure compatibility with all MMS-supported carriers, we recommend reducing the file size of your attachments before attempting to send them.

If your media is larger than the limit shown above for the destination carrier, your MMS message will fail on Twilio with error 11751.

Number of attachments supported

Twilio supports up to 10 MediaUrl attachments, as long as the total size of the message body text and all attachments is less than 5 MB. An MMS message body can be up to 1600 characters long, which equals 4.8KB or roughly 1% of the total size limit.

If your message (including body text and media) is larger than 5 MB, your message request will fail.

Incoming MMS messages

There is no size limit for incoming MMS to your Twilio numbers. Twilio does not perform any transcoding or resizing on incoming media attachments, but the handset or sending carrier may apply transcoding before the file reaches Twilio.

Additional Resources

Have more questions? Submit a request
Powered by Zendesk