Enable Chat Attachments
This guide is for Flex UI 1.x and channels that use Programmable Chat and Proxy. If you are using Flex UI 2.x or you are starting out, we recommend that you build with Flex Conversations.
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
- Customize your Webchat Attachments with the Developer Guide
- Learn how to send and receive attachments in the Attachments End User Guide
- Learn more about Programmable Chat Media Support
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.
