Docs Developer Site
Developer Docs Cms Stable Schemas Form Items Imageselector

ImageSelector input type

Contents

The ImageSelector is a specialized version of the ContentSelector that is limited to selecting images (content of type "media:image"), but also upload new images.

Appearance

Input box with a grid of images to select below it

Usage

- type: "ImageSelector"
  name: "my_image"
  label: "My Image"
  occurrences:
    min: 0
    max: 1
  allowPath:  (1)
    - "${site}/*"  (2)
  treeMode: true
  hideToggleIcon: true
1 With the exception of allowContentType (which is not supported here) and allowPath, ImageSelector supports the same configuration options as ContentSelector.
2 By default, Image Selector displays all images from the root. If you want to limit images to the same site, use allowPath: ["${site}/*"]

Output

Value type: Reference — not included in _alltext

The stored value is the content ID of the selected image. Like ContentSelector, the value is a reference to the image content item.

{
  "my_image": "f3076b5c-ea45-4c8b-8c06-1f87b8d8cdd9"
}
Multiple occurrences
{
  "my_image": [
    "f3076b5c-ea45-4c8b-8c06-1f87b8d8cdd9",
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ]
}

Contents

Contents