Image field
Log in to add to favouritesThis 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
![](/image-library/resources-images/user-guides-images/image-single.x4361b12d.png?quality=90&format=webp&width=1200px&height=680px)
![](/image-library/resources-images/user-guides-images/multiple-images.xc804c92c.png?quality=90&format=webp&width=1200px&height=680px)
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. |
Default value | The default value property sets the default content for a field when an entry is created. |
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. |
Field visibility | Determines if the field should be displayed in the collapsed state when opening the entry editor. |
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.