Filepicker

A form element to select files.

Configurable properties

General

• Field label: Label displayed on top of the Filepicker.
  • It can either be an expression, plain text, or templating syntax.
• Supported file formats: Comma-separated list of supported file formats.
  • It can either be an expression or plain text.
• Upload multiple files: Allows the user to upload multiple files at once.
  • It can be dynamically set using an expression.
• Key: Binds the field to a form variable, refer to the data binding documentation.
• Read only: Makes the Filepicker read-only, meaning the user can't change but only read its state.
  • It can be dynamically set using an expression.
• Disabled: Disables the Filepicker, for use during development.

Condition

• Hide if: Expression to hide the element.

Layout

• Columns: Space the field will use inside its row.
  • Auto means it will automatically adjust to available space in the row. Read more about the underlying grid layout in the Carbon Grid documentation.

Validation

Given that one of the following properties is set, the form will only submit when the respective condition is fulfilled. Otherwise, a validation error will be displayed.

• Required: Filepicker must have a selected file.

Reference uploaded files

The Filepicker's output variable is an array of objects with file metadata that represents each uploaded file.

It always returns an array of objects, either a user uploads a single file or multiple files. Single file uploads are accessible using value[1] (since FEEL uses 1-based indexing).

Additional guides

Design process applications for document handling with the Filepicker component.

📄️ Store, track and manage documents

Get started with document handling by uploading a document to a BPMN process, displaying and downloading a document in a user task, and sending a document to an external system via a Connector.