Pages CMS

Image field

A field allowing users to upload and select images. By default, it uses the media configuration, but can be overriden using the field's options.


Option Type Description
input string The path to the media folder relative to the root of the repo (e.g. src/files/media).
output string The path to the media folder relative to the root of the website (e.g. files/media).
path string The default path when opening the file browser.
extensions string An array of file extensions that should be displayed. If provided, any file with an extension not included in this list will not be shown to the user.
categories string Similar to media.extensions, but using categories of files: image (jpg, jpeg, png, gif, svg, bmp, tif, tiff), document (pdf, doc, docx, ppt, pptx, vxls, xlsx, txt, rtf), video (mp4, avi, mov, wmv, flv), audio (mp3, wav, aac, ogg, flac) and compressed (zip, rar, 7z, tar, gz, tgz). If both media.extensions and media.categories are provided, media.categories will be ignored.


Assuming that the media folder is set to src/media and we want to let the user pick multiple JPEG or PNG images out of the screenshots subfolder (src/media/screenshots):

- name: cover
  label: Cover
  list: true
    path: src/media/screenshots
    extensions: [ jpg, jpeg, png ]

On this page