File
Configuration reference: Ficheiro
Overview
The File component allows users to upload and manage files attached to records. It supports file type restrictions, size limits, and optional preview display.
Supported file types
By default, all file types are accepted. You can restrict uploads to specific extensions using the Allowed extensions list (e.g., pdf, jpg, png, docx).
Configuration
| Setting | Description |
|---|---|
| Hint text | Upload instruction text (e.g., "Drop a file or click to browse") |
| Button label | Custom text for the upload button |
| Allow multiple files | Accepts several files in the same column; when off, the column stores a single file |
| Max files | File limit when "Allow multiple files" is on; leave empty for no limit |
| Display mode | List (default) or Gallery (thumbnails) in the form |
| Storage subfolder | Destination subfolder inside the column's folder, to organize the files |
| Allowed extensions | List of permitted file types — leave empty to allow all |
| Max file size (MB) | Maximum allowed file size in megabytes |
| Show preview | Display a thumbnail or preview of the uploaded file in the form |
In forms, the file component shows an upload button (or drag-and-drop area). After uploading, the file name and a download link appear. In tables, files display as clickable links.
When the column has inline editing (see Table View), the table cell also shows an upload button, even when empty. In single-file mode the button disappears once a file exists; with multiple files it stays until the Max files limit. Uploads follow the same rules as the form (extensions, size, file count): each file is saved as soon as it uploads; files over the size or count limit are refused with a warning while the rest of the batch goes through; an upload failure shows an error message.