Skip to main content
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.

Appearance

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

Settings

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:

Properties

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.

Caption

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.

Dimensions

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.

Upload

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.