File / File List
This enables the uploading of one or more files. It also showcases the process of uploading by selecting or dragging a file.
Properties
The following properties are available to configure the behavior of the component from the form editor (this is in addition to common properties).
Common
Component Name string
The key for binding this upload field to form data. (Required)
Label object
Shows or hides the label for the upload field.
Tooltip string
Hover-over text providing additional context.
List Type string
Display style for uploaded files:
- File name (default)
- Thumbnail
Is Dragger boolean
Enable drag-and-drop upload (only when List Type ≠ Thumbnail).
Edit Mode object
Control interactivity:
- Editable
- Read Only
- Inherited (default)
Hide boolean
Toggles visibility of the file upload component.
Allow Upload boolean
Allows users to upload files. (default: true)
Allow Replace boolean
Permits replacing already uploaded files.
Allow Delete boolean
Grants users the ability to delete files.
Allow Add boolean
Controls whether users can add new files to the list.
Allow Remove boolean
Controls whether users can remove files from the list.
Download Zip boolean
If enabled, allows users to download all files as a zip archive.
Data
Owner ID string
Identifier linking uploaded files to an entity.
Owner Type string
Defines the entity type that owns the file (autocomplete supported).
Files Category string
A label or tag that classifies uploaded files into a specific category.
Synchronous Upload boolean
If true, uploads are handled synchronously.
Allowed File Types array
Restricts uploads to specified file types (e.g., 'image/jpeg', 'application/pdf').
Validation
Required boolean
If enabled, at least one file must be uploaded.
Appearance
Font object
Customize how your Entity picker looks. Choose the font family, size, weight, and color.
Dimensions object
Specify the size of your component:
- Width, Height
- Min/Max Width and Height
- Overflow behavior
Margin & Padding object
Fine-tune spacing inside and around the component.
Custom Styles function
Inject your own CSS styles via JavaScript (must return a style object).