How to use Chat Attachments in Live Chat Widgets

This guide explains, step by step, how to let website visitors share images and PDFs in the chat widget, and how your team can review those files in the inbox. Written from a product perspective for admins and agents. What are Chat AttachmentsChat Attachments allow visitors to include files with their chat messages. The widget supports images and PDFs and shows clear feedback while uploads are in progress.

Agents receive the files in the team inbox(CRM conversations) and can preview or download them. This is applicable only in Live Chat Widgets(website chat). No changes are required in the widget builder but the experience of the visitor is explained here. Supported file types & limitsFile types: .jpg, .jpeg, .png, .heic (iPhone photos), .pdfPer‑file size limit: up to 25 MBPer‑message limit: up to 5 filesPreview behavior: JPG/PNG: small inline preview in the chat bubble and in the inboxHEIC/PDF: shown as a filename with a download option (no inline preview)Send rule: A short text message is required to send attachmentsPre-requisitesLive Chat is installed on your websiteAgents have access to the team inbox i.e.

CRM conversationsUploading files (visitor side)DesktopClick the paperclip icon in the chat composer or drag files from your file explorer into the chat. Select up to 5 supported files (each ≤ 25 MB). Type a short message (required) and click Send. MobileTap the paperclip icon.

Choose Camera or Gallery. Pick your file(s), add a short message and Send. What visitors will see: JPG/PNG show a small preview directly in the conversation. HEIC/PDF appear as a file name with a download option.

Reviewing files (agent side)In the team inbox: Click JPG/PNG to preview or downloadClick HEIC/PDF to downloadTip: If your browser doesn’t preview HEIC, download the file and open it locally. Optional: How to allow the AI bot to respond to imagesIf you use an conversation AI agent and want it to respond to images visitors send: Go to Settings > Labs (sub - account tab) and enable Respond to images.

Open your AI Agent and toggle Allow this bot to respond to images. Current limitation: The bot can respond to images only. PDFs are not supported yet. Best practicesKeep file names clean: use letters, numbers, hyphens/underscores; avoid repeated spaces and special symbolsCompress large images before sending when on slow networksFAQs1.

Can visitors send more than one file? Yes. Up to 5 files per message. 2.

Why do I need to type a message? It keeps conversations clear and searchable; attachments require a short text. 3. Why don’t some files preview?

Only JPG/PNG preview inline. HEIC/PDF appear as a downloadable file. 4. Can I upload files from the widget builder?

No. Files are attached from the visitor chat, and agents review them in the team inbox(CRM Conversations). Troubleshooting“This file has already been attached” : Remove the duplicate and attach a different file.“This file is too big” : Reduce to ≤ 25 MB; consider compressing the image.“This file type isn’t supported” : Convert to JPG/PNG/HEIC/PDF. Drag‑and‑drop doesn’t work : Drag from your file explorer or try the paperclip picker instead.

Slow upload : Large files or slow connections take longer; compress if needed.