Overview
DemandFlow provides two row types for managing file attachments on records: File (for a primary file attachment area) and Files (for managing a collection of files stored as a property on the record). Both support uploading, downloading, and viewing attached documents.
File Row Type
The File row type creates a dedicated file management area where users can upload, view, and download files associated with the record.
File Properties
| Property | Required | Description |
|---|---|---|
| Type | Yes | Must be set to file |
| ID | Yes | The field identifier for the file attachment. |
| Header | No | A heading displayed above the file area. |
| Height | No | The height of the file area in pixels. Defaults to 500 pixels if not specified. |
| File Types | No | An array of allowed file extensions (e.g. [".pdf", ".docx", ".xlsx"]). When specified, only files matching these extensions can be uploaded. |
| Single File | No | When set to true, only one file can be attached. Uploading a new file replaces the existing one. |
| No Delete File | No | When set to true, the delete button is hidden, preventing users from removing attached files. |
Files Row Type
The Files row type manages a collection of files stored as an array property on the record. This is useful when you need multiple file attachments organised in a list.
Files Properties
| Property | Required | Description |
|---|---|---|
| Type | Yes | Must be set to files |
| Header | No | A heading displayed above the files area. |
| Property | Yes | The name of the property on the record that stores the files array. |
| Types | No | An array of allowed file type restrictions. |
File vs. Files
| Feature | File | Files |
|---|---|---|
| Storage | Managed as a dedicated file attachment | Stored as an array property on the record |
| Multiple files | Supports multiple unless Single File is enabled | Always supports multiple files |
| Best for | Primary document attachments with preview support | Collections of supporting documents |
Supported File Operations
- Upload — drag and drop files or use the upload button to attach files
- Download — click on an attached file to download it to your computer
- Delete — remove attached files (unless disabled with the No Delete File option)
- Preview — certain file types (images, PDFs) can be previewed directly within the interface
Best Practices
- Use the File Types property to restrict uploads to appropriate formats for the use case
- Place file attachments on a dedicated "Documents" or "Attachments" panel for clear organisation
- Use Single File when the record should only have one primary document (e.g. a signed contract)
- Consider using the No Delete File option for compliance scenarios where file removal should be prevented