File field

Select or upload non-image files from media.

Use for PDFs, ZIPs, docs, audio, and similar files.

Options

Key Description
media Named media config to use (e.g. "docs").
path Default browsing folder (e.g. "contracts").
multiple Allow multiple files (e.g. { max: 5 }).
extensions Allowed file extensions (e.g. ["pdf", "zip"]).
categories Allowed file categories. Values: image, document, video, audio, compressed.
unique If true, disallows duplicate file paths when multiple is enabled.
rename If true, uploaded files get a random filename plus the original extension.

Examples

Named media config and default folder

- name: brochure
  label: Brochure
  type: file
  options:
    media: docs
    path: public/files/brochures

Multiple downloadable resources

- name: resources
  label: Resources
  type: file
  options:
    categories: [document]
    multiple:
      max: 5
    unique: true
    rename: true

Specific file extensions

- name: archive
  label: Archive
  type: file
  options:
    extensions: [zip, tar, gz]