Skip to main content

Cookie control banner

Necessary Cookies
These cookies are necessary for this website to function correctly. They are set when you perform certain actions on the site, such as creating an account, logging in, changing your privacy preferences or submitting a form. You can block these cookies in your browser, but this will stop parts of the site from working properly.
Functional Cookies
These cookies allow the website to provide extra functionality and more personalised experiences. They may be set by us or by third party providers whose services we have added to our pages. If you choose not to allow these cookies, these services may not work correctly.
Analytical Cookies
These cookies record anonymous data on how visitors use our website to help us monitor how well our website works. This data includes how many people have looked at specific pages, how long visitors stay on the site, and what devices they use. We use this data to identify changes that we could make to improve your experience and make our website more efficient.
Marketing Cookies
We set some cookies so you are shown more relevant marketing content. These include cookies from third-party advertising networks to show you different adverts on their services if you have previously visited our site. If you choose not to allow these cookies, you may experience less relevant advertising on other sites.
Browse Documentation

Image field

Created by Contensis product team, last modified by r.saunders on 30 Sep 2020

This field editor allows an author to make single or multiple selections of images that have been uploaded to Contensis.

Selection is made in an image gallery. Single or multiple selection of images is determined by the multiple selection field setting.


A single image editor display a photo of Michael Caine
An example of a single image field editor
A multi image editor displaying a photo of Michael Caine and Samuel L Jackson
An example of a multiple image field editor


Setting name Summary
Name A text label to identify the field in an entry.
Field ID A sanitised name to be used by the API.
Multiple selection Allows an author to select multiple images.
Read only Prevents authors from editing the field in the entry editor.

Supported validation

This field editor supports the following validation methods:


Common properties

Property name Summary
Placeholder text The placeholder property provides a short hint describing the expected value of a field.
Content guidelines Provides guidance to an author for the expected content the field should contain.

Alt text

The alt text property determines if the alt text field should be displayed on an image field. The alt text can also be set to required once it's enabled, preventing an entry from being published until it is populated.


The caption property determines if the caption text field should be displayed on an image field. The caption can also be set to required once it's enabled, preventing an entry from being published until it is populated.


The dimensions property allows you to set the expected image dimensions for the field.The setting also determines what images are displayed in the gallery for the field, filtering out any images that do not meet the requirements.


The upload property allows you to set if an author should be allowed to upload images to the field. Images will be uploaded to the folder set in the search box. The ability for a user to upload an image is determined by their role permissions.

Limit the display of images

This property determines which images should be displayed in the image gallery for the field. All images are shown by default.