Attach files and Excel data to a chat

Attach images, PDFs and spreadsheets to a message so a Mind can read them or query them. Use this when you want a Mind to work with your own file, not with data already in the Lake or the Warehouse.

Attach a file to a message

  1. In the message box, click + to open the options row, then click Attach. On a phone, tap +, then Attach files.
  2. Or drag the files onto the message box. You can also paste files, but only when the clipboard holds no text.
  3. Wait until each file is ready. An Excel or CSV file shows Preparing tables…, then Ready with the number of tables it became, for example Ready · 3 tables. A file that cannot be read shows Failed with the reason, for example Failed · File has no header row, or Could not prepare tables.
  4. If the file shows Review PII columns, review its columns first. See the next section.
  5. Type your question and send the message.

If the selected model cannot read images or PDFs and Excel or CSV uploads are off for the Mind, Attach is locked. It shows Attachments unavailable and the reason: "The selected model can't read images or PDFs. Switch to a model that supports them to attach files."

Tip: type @ in the message to reference table cell values from a Mind's linked tables. See Chat commands, shortcuts and privacy for the @ picker and the slash commands.

Review personal data columns

Some Minds ask you to check Excel and CSV files for personal data before the model sees them. When that applies, the file shows Review PII columns. Click it to open the review.

  1. Click Review PII columns on the file.
  2. For each column, open the list under Personal data and choose a type, or keep Not personal data. The types are Name / surname, Personal / national ID, Phone number, Email, Address, Date of birth, Bank account / IBAN and Other identifier. A column with a Suggested badge starts with the type the detection suggested.
  3. If the file holds no personal data, tick I confirm this file contains no personal data instead.
  4. Click Confirm. It is unavailable until you have marked at least one column or ticked the box.

The review says: "Detection here is regex-based only (no ML). Mark every column that holds personal data; it will be tokenized before the model sees it."

Columns marked as personal data are tokenised before the model sees them. Detection on these files only looks for patterns, so check the suggestions yourself. Only the person who uploaded the file can review its columns.

If you have the Bypass PII Detection permission, the review also shows Bypass and send raw. It marks the file ready without tokenising its columns, and the bypass is recorded in the PII detection log. Your message is not sent by the bypass. Press Send yourself.

Warning

Bypass and send raw sends the columns to the model as they are. Use it only when the file is safe to share with the model.

Open, download or remove an attachment

Turn Excel and CSV uploads on or off

Excel and CSV uploads are a setting of each Mind. Open the Mind under Minds, then its Settings tab.

SettingWhat it doesDefault
Allow Excel / CSV uploadsLets people attach .xlsx, .xlsm, .csv and .tsv files in this Mind's chats. When it is off, those files are refused.On for an Analytical Mind. Off for a Warehouse Builder or Lake Builder Mind.
Enforce PII column clarificationMakes people review the personal data columns of each Excel and CSV file before it can be sent.Off

Enforce PII column clarification can be switched on only while Allow Excel / CSV uploads is on and global PII detection is on. When global PII detection is off, the setting shows Turn on Global PII detection first. If an administrator turns global PII detection off, every Mind has this setting switched off.

See Create and configure a Mind for the full settings reference, and PII detection for the global switch.

Limits and edge cases

File typeLargest sizePer messagePer chat
Images: JPEG, PNG, GIF, WebP3.75 MB, and no side longer than 8000 px20Refused once more than 20 images are sent
PDF30 MB, and no more than 100 pages5Refused once more than 5 PDFs are sent
Excel and CSV: .xlsx, .xlsm, .csv, .tsv15 MBNo separate limit5

Who can do what

Questions, answered

Can the Mind query my spreadsheet?

Yes. Each sheet of an .xlsx or .xlsm file, and each CSV or TSV file, becomes a table the Mind can query. The file's tile shows how many tables it became.

Can other chats use my spreadsheet?

No. The tables exist only inside the chat where you attached the file.

How many files can I attach to one message?

Up to 20 images and up to 5 PDFs in one message. Excel and CSV files have no per-message limit, but the chat holds up to 5 of them. Images and PDFs already sent in the chat count too, so a full chat can refuse a new message.

Why is my .xls file refused?

Legacy .xls files are not supported. Save the file as .xlsx or .csv, then upload it again.

Why can't I attach an image or a PDF?

Two things can stop it. Attach is locked, showing Attachments unavailable, when the selected model cannot read images or PDFs and Excel or CSV uploads are off for the Mind. Or the file is refused with Not supported by this model because the selected model cannot read that kind. Switch to a model that supports images or PDFs, then attach the file again.

Why can't I send my message after I attached a CSV?

The file is still being prepared, has failed, or is waiting for PII review. The Excel / CSV attachment not ready message says which. Finish the review or remove the failed file, then send.

Who can review a file's personal data columns?

Only the person who uploaded the file. If someone else attached it, ask them to open Review PII columns and finish the review; another person trying to review it sees "Only the uploader can confirm PII columns for this attachment."

Does the PII review apply to PDFs and images?

No. Only Excel and CSV files open Review PII columns.

Where is a PII bypass recorded?

In the PII log, under Observability > Logs > PII. See AI, socket and PII logs.

Why do I see "Excel / CSV uploads are disabled for this Mind"?

Someone has switched off Allow Excel / CSV uploads for this Mind. Ask a person with Edit Mind to turn it on, or load the file into the Lake instead. See Load files.

Why did my CSV disappear when I switched Mind?

Excel and CSV files do not move between Minds. Switching removes them. Images and PDFs stay with you.

Can I remove a file before I send it?

Yes, if you are the uploader. Point to the file and click its remove button before you send it. After the message is sent, the attachment stays in the chat.