File

The File custom field attaches files directly to records. It supports documents, spreadsheets, images, PDFs, and most other file types.

Upload and access files

Each File field accepts multiple files. Signed-in users can upload a file up to 4.8 GB. Anonymous uploads through public forms can be up to 500 MB.

Blue can preview supported file types, including images, PDFs, and Word documents. A workspace member can access an attached file only if their role can access Files, the record, and the File field.

Blue also shows uploaded files in the workspace Files tab. Custom user roles with restricted record access cannot see files from those records.

Organize files into folders

Each File field has its own folders, separate from the workspace Files tab. Open the field in list or grid view, create folders and subfolders, then move files into them.

• A File field supports up to 10 folder levels and up to 100 folders.
• Only workspace owners and admins can create, rename, move, or delete folders. Any member who can edit the field can still upload, move, and remove files.
• Deleting a folder also deletes every file inside it, after a warning.
• Files added through public forms or automations go to the field’s root.

You can set default folders that new records inherit. Applying a folder template to existing records only adds folders that are missing; it never moves or deletes files you already have.

Share a folder publicly

Users who can manage custom fields can share a folder inside a File field. Open the folder menu and select Share folder. Blue creates a public link and copies it to the clipboard.

Recipients do not need a Blue account. They see the folder name, its subfolders, and its files — never the record, field, or workspace name. Select Turn off sharing to close the link.

Collect files through forms

Add a File custom field to a form to let external users upload files with a submission. They do not need a Blue account.

Blue attaches the uploaded files to the records generated from form submissions. For example, candidates can attach CVs and cover letters to job applications. Customers can submit images for creative requests, and clients can submit intake documents.

Access files through the API

The Blue API accesses File field uploads through the standard file-related API calls. Use these calls to download, upload, organize, or integrate files programmatically. You can also process uploaded files or add metadata.