For the complete documentation index, see llms.txt.
Skip to main content
Version: 8.8

Filepicker

A form element to select files.

Form Filepicker Symbol

Configurable properties​

General​

  • Field label: Label displayed on top of the Filepicker.
  • Supported file formats: Comma-separated list of supported file formats.
  • Upload multiple files: Allows the user to upload multiple files at once.
  • 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.
  • Disabled: Disables the Filepicker, for use during development.

Condition​

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.