How to Use Chat Attachments in Sparkforge Live Chat Widgets

By Sparkforge Support Team ·Last reviewed May 3, 2026

Visitors can attach up to 5 images or PDFs (25 MB each) to a chat message, and agents review them in the team inbox. JPG/PNG preview inline; HEIC and PDF download.

Chat Attachments let website visitors share files inside the live chat widget. Agents pick them up in the team inbox under CRM conversations.

Supported files and limits

  • File types: .jpg, .jpeg, .png, .heic (iPhone photos), .pdf
  • Per-file size: up to 25 MB
  • Per-message: up to 5 files
  • Send rule: a short text message is required when attaching files

Preview behavior

  • JPG/PNG: small inline preview in the chat bubble and the inbox
  • HEIC/PDF: shown as a filename with a download option (no inline preview)

Prerequisites

  • Live Chat is installed on your website
  • Agents have access to the team inbox (CRM conversations)

How visitors upload files

Desktop

  1. Click the paperclip icon in the chat composer or drag files in from the file explorer.
  2. Select up to 5 supported files (each ≤ 25 MB).
  3. Type a short message and click Send.

Mobile

  1. Tap the paperclip icon.
  2. Choose Camera or Gallery.
  3. Pick the file(s), add a short message, then send.

How agents review files

In the team inbox, click JPG/PNG to preview or download. Click HEIC/PDF to download. If your browser does not preview HEIC, download and open it locally.

Let the AI bot respond to images

  1. Go to Settings > Labs (sub-account tab) and enable Respond to images.
  2. Open your AI Agent and toggle Allow this bot to respond to images.

The bot can respond to images only — PDFs are not supported yet.

Best practices

  • Keep file names clean: letters, numbers, hyphens, and underscores.
  • Compress large images before sending on slow networks.

Troubleshooting

  • "This file has already been attached" — remove the duplicate and attach a different file.
  • "This file is too big" — reduce to ≤ 25 MB; compress if needed.
  • "This file type isn't supported" — convert to JPG, PNG, HEIC, or PDF.
  • Drag-and-drop fails — use the paperclip picker.

Frequently Asked Questions

How many files can a visitor send in one chat message?
Up to 5 files per message, each 25 MB or smaller.
Why is a short text message required to send attachments?
It keeps conversations searchable and prevents file-only messages that lack context.
Why don't HEIC and PDF files preview inline?
Only JPG and PNG render an inline preview. HEIC and PDF appear as downloadable filenames in the chat bubble and inbox.
Can my AI agent reply to image attachments?
Yes. Enable Respond to images in Settings > Labs and toggle Allow this bot to respond to images on the agent. PDFs are not supported yet.
Does the widget builder upload files?
No. Files are attached from the visitor chat. Agents review them in the team inbox under CRM conversations.

Was this article helpful?

Related Articles