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 Controls upload renaming. Use false to keep the original filename, true or safe to slugify it, or random for a generated name.

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]