Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.teable.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Attachment field stores one or more files in a record. Common use cases include contracts, images, invoices, design files, resumes, reports, and images generated by AI fields.

Use Cases

ScenarioGood for
File archiveContracts, invoices, reports, resumes, and other business files
Image and asset managementProduct images, campaign assets, design files, screenshots
Form file collectionResumes, reimbursement receipts, and files submitted by customers
AI image outputImage results generated by AI fields

Create and Configure

1

Choose the field type

In a table, click + to add a field, then choose Attachment.
2

Name the field

Enter a field name, such as “Files”, “Images”, or “Contract attachments”.
3

Save the field

After saving, each record can upload one or more files in this field.

Upload and View

Attachment fields can store images, PDFs, documents, archives, and other file types.
  • Upload files: Click the attachment area in a cell or record detail, then choose local files to upload.
  • Store multiple attachments: One attachment cell can contain multiple files.
  • Preview files: Images and some file types can be previewed in the cell or record detail.
  • Download one attachment: Open an attachment, then download the file.
Attachment fields store files, not plain text. When converting a text field to an attachment field, Teable cannot convert the original text into files. Check whether the data needs a backup before converting the field.

Batch Download Attachments

From the attachment field menu, you can download attachments from the current field as a ZIP file. The download scope follows the current table search results:
  • If no search is active, Teable downloads downloadable attachments in this attachment field.
  • If the table is searching and hiding unmatched rows, Teable only downloads attachments from matching records.
When downloading the ZIP, you can choose an attachment filename prefix:
Prefix optionDescription
Default indexUses a system-generated index as the prefix, which helps keep file order clear
Select a field as prefixUses another field value as the filename prefix, useful for organizing files by ID, customer name, or project name
No prefixKeeps the original filename where possible
If duplicate filenames appear in the ZIP file, Teable adds suffixes so each filename stays unique.

Use with AI Fields

AI fields can read attachments and write generated images to attachment fields.
  • Read attachments: In AI field settings, add the attachment field as an input field. Whether the AI field can recognize image or file content depends on the selected model.
  • Save images: Set the AI field output to an attachment field. Generated images are saved to that field.
For more information, see AI Field.

Upload Attachments Through API

The attachment upload API supports local file upload and URL-based upload. New attachments are appended to the end of the target attachment field in the specified record. See Upload Attachment API.
Last modified on May 26, 2026