Image field

Select or upload images from media.

Use for cover images, thumbnails, galleries, logos.

Options

Key Description
media Named media config to use (e.g. "images").
path Default browsing folder (e.g. "blog").
multiple Allow multiple images (e.g. { max: 6 }).
extensions Allowed image extensions (e.g. ["jpg", "png", "webp"]).
categories Allowed image categories. Values: image.
unique If true, disallows duplicate image 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: cover
  label: Cover image
  type: image
  options:
    media: images
    path: public/images/posts

Multiple images

- name: gallery
  label: Gallery
  type: image
  options:
    multiple:
      max: 6
    unique: true
    extensions: [jpg, png, webp]
    rename: true

Category-based restriction

- name: thumbnail
  label: Thumbnail
  type: image
  options:
    categories: [image]