Enable Chat Attachments (Webchat 2.0)

This guide is for Flex UI 1.x.x and channels that use Programmable Chat and Proxy. If you are using Flex UI 2.x.x or you are starting out, we recommend that you build with Webchat 3.0.

This Twilio product is currently available as a Public 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 Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

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

Thanks for your feedback!