Enable Chat Attachments


This Twilio product is currently available as a beta release. Some features are not yet implemented and others may be changed before the product is declared as Generally Available. Beta products are not covered by a Twilio SLA. Learn more about beta product support.

Attachment support in the Flex UI allows agents and customers to share files such as documents and images over a chat channel. To enable the web chat attachment pilot you’ll need to be on Flex UI 1.20 and Flex Web Chat 2.5.

You have to enable chat attachments in both the Flex UI and Web Chat UI.

Enabling attachments in Flex UI

To enable chat attachments in the Flex UI, visit the pre-release features page within Flex Admin.

Enable attachments in WebChat UI

To enable sending attachments between agents and customers, add the following code to Flex Web Chat UI webchat-appConfig.js configuration files.

fileAttachment: {
   enabled: true

Enable read-only mode for Flex UI or WebChat UI

If you want to limit users (customers or agents) from sending attachments but still want he to be able to see and download attachments sent to them, then you can configure attachments feature to be in readOnly mode.

fileAttachment: {
readOnly: true

Default Configuration

The default configuration allows the following files types to be sent. The file can be up to 10Mb in size.

Images Documents
.jpeg, .jpg, .png, .gif .txt, .pdf

Next Steps

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

Refer us and get $10 in 3 simple steps!

Step 1

Get link

Get a free personal referral link here

Step 2

Give $10

Your user signs up and upgrade using link

Step 3

Get $10

1,250 free SMSes
OR 1,000 free voice mins
OR 12,000 chats
OR more