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 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: 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]