Skip to Content
AgentsAttaching Files

Attaching Files

You can send photos, documents, videos, and voice recordings directly to your agent while chatting. The agent opens whatever you send, reads it, and puts it to work.

How to attach a file

  1. Click the + button to the left of the chat input and choose Attach file or Attach Photo.
  2. Or drag a file straight onto the chat window and drop it.
  3. Or copy an image and paste it into the input box.

You can review attached files before sending and remove any you don’t need.

Supported file types

CategoryFormats
PhotosPNG, JPG, WEBP, GIF
DocumentsPDF, Word (.doc/.docx), RTF, PowerPoint (.ppt/.pptx)
SpreadsheetsExcel (.xls/.xlsx), CSV, TSV
Text & codeTXT, Markdown, HTML, JSON, XML, YAML, and most code/config files (.py, .js, .ts, .java, etc.)
ArchivesZIP
VideoMP4, MOV, WEBM, M4V
AudioMP3, WAV, M4A, AAC, OGG, FLAC

Audio is a recently added category. Before this, only photos, documents, and video could be attached — recordings and voice memos were rejected.

Some formats aren’t supported, such as executable files or compressed archives other than ZIP. If you try to attach an unsupported format, you’ll see a notice explaining why.

Size and count limits

  • Each file can be up to 500MB. Larger files are automatically excluded, with a notice explaining why.
  • The number of files you can attach to a single message depends on your plan: up to 4 on Free, Starter, and Pro, and up to 10 on Enterprise.
  • If a message includes files that exceed the size or count limit, only those files are dropped — a notice tells you which ones.

What happens after you send it

Photos stay in the chat, so you can scroll back and view them again. That said, they’re only kept for 90 days — after that, the original is automatically deleted and the attachment card shows a removal notice instead. Keep your own copy of any photo you’ll want long-term.

Everything else — documents, spreadsheets, slides, video, audio — is read and used by the agent right away, but you can’t reopen or re-download it from the chat afterward. The attachment card shows it as an “Agent working file” instead. If you’ll need the file again later, keep your own copy of it.


Advanced

The details below matter only if you want to understand how this works internally or are troubleshooting an issue.

  • File type is determined by the file extension, not the MIME type your browser or app reports. If the extension isn’t on the supported list, the server rejects it. Files with no extension are only accepted when the type your browser reports alongside them is on the supported list — in practice that’s almost always a pasted screenshot, which arrives with a photo type but no filename or extension.
  • Only photos are stored in a way that keeps them viewable in chat afterward, and only for 90 days (a bucket-wide storage lifecycle policy). Every other format (documents, spreadsheets, slides, video, audio) is never stored at all — it’s handed directly to the agent’s working environment, which is why it can’t be re-downloaded from chat later.
  • The per-file limit is 500MB. Web and Android filter the file picker down to supported formats before you even select one; iOS does not pre-filter at the picker level, so the server always makes the final call on whether a file is accepted.
  • Full list of supported extensions — Photos: png jpg jpeg webp gif · Documents: pdf docx doc rtf txt md html htm json xml yaml yml · Spreadsheets: xlsx xls csv tsv · Slides: pptx ppt · Archives: zip · Video: mp4 m4v mov webm · Audio: mp3 wav m4a aac ogg flac · plus a wide range of programming language and config file extensions.