Skip to main content
Yes. Customers can send images, PDFs, and some documents to your Chatbase AI agent, and it reads them and answers based on what they contain, for example a screenshot of an error or a photo of a damaged item. This page is for anyone deciding whether to let customers send files: it lists the formats and limits on each channel, which models can read images, what the AI agent can send back, and how attachments add to your message credits.

Which channels accept attachments

For Word, Excel, and text files, the AI agent reads only the text. Images and charts inside them aren’t processed. Other file types are discarded. On the Chat Bubble and Help Page, customers can only attach files when attachments are turned on:
  • Chat Bubble and Center Stage: Display tab, Capabilities, Attachments.
  • Help Page: Capabilities, Enable attachments.
See Capabilities.

Limits

Files over these limits are ignored. On Email, every attachment is still saved with the conversation, except files flagged as viruses, and the AI agent tells the customer in one sentence that it couldn’t read a file that was too large. See Attachments, Email attachments, and Slack attachments.

Which models can read images

The AI agent can read an image only if its AI model supports it. Auto, the default model, has image understanding built in, as do GPT-6.1 Sol and Gemini 3.8 Flash. On Email, the AI agent reads attachments only when its model supports them. If you use another model, send a test image in the Playground before you rely on it, or compare models with Compare on Build > Instructions.

What customers can do with it

  • Show a problem. A screenshot of an error message, or a photo of a damaged or wrong item.
  • Share a document. An invoice, a PDF form, or a spreadsheet of order numbers.
  • Find a product. With Shopify Actions, a shopper can send a photo, such as a screenshot from social media, and the AI agent shows matching products from your catalog. No extra setup is needed once products are synced.
  • Reply to an Instagram story. The AI agent gets the story as context: it reads what an image story shows, but for a video story it only knows the customer is replying to a video.

Ask for a photo in a Procedure

To make a photo part of a flow, ask for it in a Procedure step. Example steps for a damage claim:
With Escalations on the Chatbase Helpdesk, you can also add an Image custom field so a photo is collected and saved on the ticket. With Collect from a form, photos are always uploaded in the form, and a ticket holds at most 5 files across image fields and attachments.

What the AI agent can send back

  • Images in the Chat Bubble: the AI agent can show an image by sending a markdown image link whose URL ends in .png or .jpg. Add it to your instructions. See Add suggestable images.
  • Widgets: a Widget can show images, cards, and tables in the chat, and can accept file uploads that go to your own endpoint.
  • Email: the AI agent can’t attach files to its email replies.
  • Your team: teammates replying from the Helpdesk can attach up to 5 files of up to 25 MB each. In emails, the files appear as download links.

Credits

Attachments add message credits on top of the reply. Each image costs credits, and each PDF costs credits per page. With a model that costs 1 credit, a message with one image and a 3-page PDF costs 1 (text) + 1 (image) + 3 (PDF pages) = 5 credits. If the message also triggers an Action, the attachments are processed twice, once for the Action and once for the reply, so they’re charged twice. See Billing and Usage.

Limitations

  • Attachments don’t reach most third-party ticket platforms. When the AI agent escalates to a platform other than Zendesk, the ticket gets an AI summary and a link to the conversation, not the files. Zendesk is the only platform that can receive the full conversation transcript with the customer’s files attached. See Zendesk.
  • Helpdesk Translation doesn’t translate images. Text inside images and attachments stays in the original language. See Translation.
  • Data Sources are text only. Images, charts, and videos inside your training documents aren’t read. Put important information from them into text. See Data Sources.

Frequently asked questions

Yes, if its model supports images. Auto, the default, does. Customers can send PNG and JPG images on the Chat Bubble, Help Page, Center Stage, WhatsApp, Messenger, Instagram, Email, and Slack, up to 5 MB each.
Check the format and size for that channel, the 5-file and 5-page limits, and that attachments are turned on under Capabilities for the Chat Bubble or Help Page. Also check that the AI agent’s model can read images.
Yes, on WhatsApp, Messenger, Instagram, and Slack. Voice messages are transcribed to text and the AI agent replies to what was said. Customers can also attach audio files on Email. For spoken conversations on your website, turn on Voice or Voice to text (Dictation).
Each image adds credits on top of the reply, at the model’s rate, and each PDF page does too. With a 1-credit model, a reply to a message with one image costs 2 credits. If the message triggers an Action, the image is charged twice.
In the Chat Bubble, it can show images through markdown image links in its reply, or through a Widget. It can’t attach files to email replies. Your team can attach files from the Helpdesk.

Channels: Attachments

Formats, limits, and billing in full.

Models comparison

Pick a model that fits your workload.

Shopify Actions

Let shoppers search your catalog by photo.

Procedures

Ask for a photo as one step of a flow.