field.file

This component can be used for uploading files. It's displayed in the interface as an upload button.

You can restrict the file types to upload in the "accept" property. By default, only one file can be uploaded, but you can allow multiple files in the "multiple" property.

If a user logs in from a mobile device, it's more convenient to use field.media-file — it's adapted for mobile devices and makes it easier to upload photos and videos.

View example in sandbox.

Component properties

NameTypeDescription
type*"field.file"

Set component type

data*writable

Data with values that will be processed or changed.

labelstring

Label above the component.

acceptarray

A list of file types that can be uploaded. By default, you can upload any files.

Specify the types in the format (https://developer.mozilla.org/en-US/docs/Web/HTTP/BasicsofHTTP/MIME_types). For example, you can allow only images to be uploaded by adding the image/jpeg and image/png types.

accept[]string

File type in the MIME Type format which is allowed for upload in the "accept" property.

hintstring

Hint text.

multipleboolean

Determines whether multiple files can be uploaded:

  • false (default) — forbidden.
  • true — allowed.
validationcondition

Validation based on condition.