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.
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: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
.pngor.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
Can my AI agent understand screenshots and photos?
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.
Why did my AI agent ignore an attachment?
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.
Can customers send voice messages?
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 or Voice to text (Dictation).
How many credits does an image use?
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.
Can the AI agent send files or images to customers?
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
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.