> ## Documentation Index
> Fetch the complete documentation index at: https://chatbase.co/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Can your AI agent read images and files customers send?

> Which images, PDFs, documents, and audio files your Chatbase AI agent can read on each channel, the limits, what it can send back, and how attachments use credits.

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

| Channel | Images | Documents | Audio |
| - | - | - | - |
| **Chat Bubble**, **Help Page**, **Center Stage** | PNG, JPG, JPEG | PDF | No |
| **WhatsApp**, **Messenger**, **Instagram** | PNG, JPG, JPEG | PDF, DOCX, XLSX, TXT | Voice messages |
| **Email** | JPEG, PNG, GIF, WebP | PDF, DOCX, XLSX, TXT | OGG, MPEG, MP4, AAC, AMR, M4A, WebM |
| **Slack** | JPEG, PNG | PDF | Any audio format, transcribed to text |

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](https://chatbase.co/docs/user-guides/chatbot/channels.md#capabilities).

## Limits

| Limit | Chat channels | Email | Slack |
| - | - | - | - |
| Files per message | 5 | 5 read per email | Not documented |
| Size per file | 5 MB | 5 MB, 16 MB for audio | 5 MB for images and PDFs |
| PDF length | 5 pages | | |

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](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments), [Email attachments](https://chatbase.co/docs/user-guides/integrations/email.md#attachments), and [Slack attachments](https://chatbase.co/docs/user-guides/integrations/slack.md#attachments-and-audio).

## Which models can read images

The AI agent can read an image only if its [AI model](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md) 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](https://chatbase.co/docs/user-guides/chatbot/playground.md) 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](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md#search-by-image), 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](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md) step. **Example** steps for a damage claim:

```text theme={null}
1. Use @Get_Orders to find the order the customer is asking about.
2. Ask which item is affected and what is wrong with it.
3. If the item is damaged:
     Ask the customer to send a photo of the damage.
4. Describe what the photo shows in one sentence and ask the customer to confirm.
5. Use @create_ticket with the order number and a description of the issue.
```

With [Escalations](https://chatbase.co/docs/user-guides/chatbot/actions/escalate-to-human.md) on the Chatbase Helpdesk, you can also add an **Image** [custom field](https://chatbase.co/docs/user-guides/chatbot/help-desk/custom-fields.md) 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](https://chatbase.co/docs/user-guides/quick-start/best-practices.md#add-suggestable-images).
* **Widgets:** a [Widget](https://chatbase.co/docs/developer-guides/widgets/overview.md) 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](https://chatbase.co/docs/user-guides/chatbot/help-desk/help-desk-overview.md#attachments) 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](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments) and [Usage](https://chatbase.co/docs/user-guides/workspace/usage.md).

## 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](https://chatbase.co/docs/user-guides/integrations/zendesk.md).
* **Helpdesk Translation doesn't translate images.** Text inside images and attachments stays in the original language. See [Translation](https://chatbase.co/docs/user-guides/chatbot/help-desk/translation.md).
* **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](https://chatbase.co/docs/user-guides/chatbot/data-sources.md).

## Frequently asked questions

> [accordion] Can my AI agent understand screenshots and photos?
>
> 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.

> [accordion] Why did my AI agent ignore an attachment?
>
> 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.

> [accordion] Can customers send voice messages?
>
> 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](https://chatbase.co/docs/user-guides/chatbot/voice.md) or **Voice to text (Dictation)**.

> [accordion] How many credits does an image use?
>
> 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.

> [accordion] Can the AI agent send files or images to customers?
>
> 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.

## Related

> [card] [Channels: Attachments](https://chatbase.co/docs/user-guides/chatbot/channels.md#attachments)
>
> Formats, limits, and billing in full.

> [card] [Models comparison](https://chatbase.co/docs/user-guides/chatbot/models-comparison.md)
>
> Pick a model that fits your workload.

> [card] [Shopify Actions](https://chatbase.co/docs/user-guides/chatbot/actions/shopify-actions.md)
>
> Let shoppers search your catalog by photo.

> [card] [Procedures](https://chatbase.co/docs/user-guides/chatbot/procedures/procedures-overview.md)
>
> Ask for a photo as one step of a flow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.