File Upload

Type key: file_upload. Renders a drop zone where respondents attach one or more files. In the editor this is the File Upload block.

A question: the question rules apply, and it can sit in a layout row column.

Meta fields

The meta fields of this node type are listed in the request body of Replace the draft document, under pages › nodes, in the file_upload tab.

Example

A minimal File Upload node

{
  "public_id": "nCv1",
  "sort_order": 1,
  "type": "file_upload",
  "meta": {
    "question": "<span>Upload your talk slides</span>",
    "file_upload_accepted_categories": [
      "document"
    ],
    "file_upload_max_files": 1,
    "validation": {
      "required": false
    }
  }
}

Defaults and rules

• file_upload_accepted_categories lists any of image, video, audio, document, and archive. Omitted or null, the question accepts every category.
• file_upload_max_files defaults to 1 and accepts 1 to 20; null allows the maximum of 20 files per answer.
• file_upload_max_file_size_mb caps each file in megabytes. Omitted or null, only the plan’s file size limit applies; a value above that limit does not raise it.
• The node has no default_value.