File fields

The file drop. It accepts drag and drop, enforces the allowed extensions and stores the file in the component's file table. It is also the target of the two blocks that produce a file without going through the user's disk: photo capture and the code scanner.

What it is

TypefieldInputFile
Categoryform
Children allowed0
Styling targetsbspk, input, label
EventsonChange

The settings

Only the settings specific to this block are listed here. The block name, HTML id, anchor, conditional display and repetition are shared by every block and described once, under Shared settings.

Parameters

SettingHow it is setWhat it doesSpecifics
Field name
vt_FieldName
text (text)—required

Label & texts

SettingHow it is setWhat it doesSpecifics
Field label
vt_FieldLabel
text (text)—translatable

Input & behavior

SettingHow it is setWhat it doesSpecifics
Camera
vb_Capture
toggle (boolean)Adds the capture attribute to the field: on mobile, picking a file opens the camera directly. No effect on desktop.default: no
Drop Zone
vb_DropZone
toggle (boolean)—default: no
Allow adding multiple files
vb_MultiFile
toggle (boolean)—default: no
Show the preview of the file
vb_Preview
toggle (boolean)—default: no
Show accepted file types
vb_showAcceptType
toggle (boolean)—default: no
Accepted file types
vt_AcceptType
select (text)Pick from the list or type a custom entry (e.g. .heic, application/json) and press Enter. Empty = all files accepted.multiple values, open list

Storage

SettingHow it is setWhat it doesSpecifics
Is linked to the module entity?
vb_isLinkedToModuleEntity
toggle (boolean)—default: no
Storage path
vt_PathStockage
text (text)Path of the folder where the file is dropped. Can be a "Storage" variable instead of a hard-coded path.
Save method
vt_WhereToStore
select (text)—default: pathFolder

The tables on this page are produced automatically from the block's schema. If this page and the panel disagree, the schema is right.