Skip to content

Reference

Media reference

Download Markdown

Open a page in Composer in the site admin and select the section you are inspecting. Use Settings and Appearance alongside the fields below. Read the shared field guide for the meaning of the table columns.

Checked against the product’s code on 7 November 2026.

This reference lists the catalog fields and their basic starter configuration. Read Shared section fields for the default rules and the shared groups of fields added to these sections. A chosen preset can start with different values.

Viewport means the browser’s visible area. Renditions are saved copies of a picture at different sizes.

A collection of pictures with layout, captions and presentation controls.

In a public gallery grid on a library theme or a site that was not migrated, a caption without a picture is left out. On a site that was not migrated, a native Gallery with no pictures draws nothing for visitors, in any layout. Composer keeps a Picture slot for an empty native gallery. A carousel with pictures still keeps its empty slides.

Also carries: Advanced fields, Appearance fields. See shared fields.

Field Input Required Choices Field default Starter value
Section number
pxLabelNumber
Formatted text No No fixed list Not declared Not set
Section label
pxLabel
Formatted text No No fixed list Not declared Not set
Headline
headline
Formatted text No No fixed list Not declared Not set
Layout
layout
Choice No Grid (grid); Carousel (carousel); Masonry (masonry); Before / after pairs (beforeAfter) Not declared Grid
Captions
captions
Choice No Below the image (default) (below); Overlay title on hover (overlay) Not declared Not set
Image size served (declared by the source)
imageSize
Choice No Thumbnail (150×150 crop) (thumbnail); Medium (≤300px) (medium); Medium-large (≤768px) (medium_large); Large (≤1024px) (large); Full size (full) Not declared Not set
Image corner radius (declared by the source, e.g. 0px 0px 0px 0px)
imageRadius
Text No No fixed list Not declared Not set
Image sizing
imageSizing
Choice No Native gallery sizing (default) (native); Full width with declared proportions and fit (fluid); Declared image height (declared-height) Not declared Not set
Image height (auto or pixels, e.g. 240px)
imageHeight
Text No No fixed list Not declared Not set
Minimum image height (auto or pixels)
imageMinHeight
Text No No fixed list Not declared Not set
Maximum image height (none or pixels)
imageMaxHeight
Text No No fixed list Not declared Not set
Image proportions (auto for natural size, or e.g. 4 / 3)
cardImageAspect
Text No No fixed list Not declared Not set
Image position (horizontal and vertical, e.g. 20% 80%)
imagePosition
Text No No fixed list Not declared Not set
Image fit
cardImageFit
Choice No Fill (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down) Not declared Not set
Slides per view (carousel)
slidesPerView
Number No No fixed list Not declared Not set
Source viewport ranges
responsiveProfile
Source viewport ranges No No fixed list Not declared Not set
Carousel layout at a viewport cutoff
carouselBreakpointMode
Choice No Keep the smaller layout at the cutoff (default) (max-width); Start the larger layout at the cutoff (min-width) Not declared Not set
Slides per view, tablet (carousel)
slidesPerViewTablet
Number No No fixed list Not declared Not set
Slides per view, mobile (carousel)
slidesPerViewMobile
Number No No fixed list Not declared Not set
Carousel slide position (declared by the source)
carouselAlignment
Choice No At the start of the strip (start); Centred, its neighbours peeking on both sides (center) Not declared Not set
Space between slides (carousel, declared by the source, e.g. 0px)
slideGap
Text No No fixed list Not declared Not set
Space between slides, tablet (carousel)
slideGapTablet
Text No No fixed list Not declared Not set
Space between slides, mobile (carousel)
slideGapMobile
Text No No fixed list Not declared Not set
Images sit inline on the text baseline (the source builder’s carousel anatomy)
imageInline
Yes or no No No fixed list Not declared Not set
Grid columns
columns
Number No No fixed list Not declared Not set
Carousel autoplay interval (ms; empty = off)
autoplayMs
Number No No fixed list Not declared Not set
Carousel controls
carouselNavigation
Choice No Arrows and dots (both); Arrows only (arrows); Dots only (dots); None (none) Not declared Not set
Carousel loops (declared by the source; Elementor infinite)
loop
Yes or no No No fixed list Not declared Not set
Slides per step (carousel)
slidesToScroll
Number No No fixed list Not declared Not set
Slides per step, tablet (carousel)
slidesToScrollTablet
Number No No fixed list Not declared Not set
Slides per step, mobile (carousel)
slidesToScrollMobile
Number No No fixed list Not declared Not set
Open full size on click
lightbox
Yes or no No No fixed list Yes Not set
Images
images
List of entries No No fixed list Not declared Empty list
Image URL
images[].url
Picture Yes No fixed list Not declared Not set
Alt text
images[].alt
Text No No fixed list Not declared Not set
Picture fit
images[].fit
Choice No Show the whole picture (whole); Fill the frame (fill) Show the whole picture Not set
Caption
images[].caption
Formatted text No No fixed list Not declared Not set
Image width attribute
images[].width
Number No No fixed list Not declared Not set
Image height attribute
images[].height
Number No No fixed list Not declared Not set
Image loading (declared by the source; absence means eager)
images[].loading
Choice No Eager (loads immediately) (eager); Lazy (loads once scrolled into view) (lazy) Not declared Not set
Image decoding (declared by the source)
images[].decoding
Choice No Async (async); Sync (sync); Auto (auto) Not declared Not set
Image fetch priority (declared by the source)
images[].fetchPriority
Choice No High (high); Low (low); Auto (auto) Not declared Not set
This image’s corner radius
images[].imageRadius
Text No No fixed list Not declared Not set
This image’s sizing
images[].imageSizing
Choice No Use gallery setting (gallery); Full width, automatic height (fluid); Declared image height (declared-height) Not declared Not set
This image’s height (auto or pixels, e.g. 240px)
images[].imageHeight
Text No No fixed list Not declared Not set
This image’s minimum height (auto or pixels)
images[].imageMinHeight
Text No No fixed list Not declared Not set
This image’s maximum height (none or pixels)
images[].imageMaxHeight
Text No No fixed list Not declared Not set
This image’s proportions (auto or width / height)
images[].aspectRatio
Text No No fixed list Not declared Not set
This image’s fit
images[].objectFit
Choice No Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down) Not declared Not set
This image’s crop position (horizontal% vertical%)
images[].objectPosition
Text No No fixed list Not declared Not set
This image’s corner radius, tablet
images[].imageRadiusTablet
Text No No fixed list Not declared Not set
This image’s corner radius, mobile
images[].imageRadiusMobile
Text No No fixed list Not declared Not set
This image’s height, tablet (auto or pixels)
images[].imageHeightTablet
Text No No fixed list Not declared Not set
This image’s height, mobile (auto or pixels)
images[].imageHeightMobile
Text No No fixed list Not declared Not set
This image’s minimum height, tablet (auto or pixels)
images[].imageMinHeightTablet
Text No No fixed list Not declared Not set
This image’s maximum height, tablet (none or pixels)
images[].imageMaxHeightTablet
Text No No fixed list Not declared Not set
This image’s minimum height, mobile (auto or pixels)
images[].imageMinHeightMobile
Text No No fixed list Not declared Not set
This image’s maximum height, mobile (none or pixels)
images[].imageMaxHeightMobile
Text No No fixed list Not declared Not set
This image’s proportions, tablet
images[].aspectRatioTablet
Text No No fixed list Not declared Not set
This image’s proportions, mobile
images[].aspectRatioMobile
Text No No fixed list Not declared Not set
This image’s fit, tablet
images[].objectFitTablet
Choice No Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down) Not declared Not set
This image’s fit, mobile
images[].objectFitMobile
Choice No Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down) Not declared Not set
This image’s crop position, tablet (horizontal% vertical%)
images[].objectPositionTablet
Text No No fixed list Not declared Not set
This image’s crop position, mobile (horizontal% vertical%)
images[].objectPositionMobile
Text No No fixed list Not declared Not set
Spotlight (spans 2x2 in the grid)
images[].span
Yes or no No No fixed list Not declared Not set
Compare image (the “after” frame)
images[].compareUrl
Picture No No fixed list Not declared Not set
Compare image alt text
images[].compareAlt
Text No No fixed list Not declared Not set
Registered renditions (stamped at import; JSON of size → file)
images[].renditions
Picture No No fixed list Not declared Not set

Section number
pxLabelNumber

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Section label
pxLabel

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Headline
headline

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Layout
layout

Input
Choice
Required
No
Choices
Grid (grid); Carousel (carousel); Masonry (masonry); Before / after pairs (beforeAfter)
Field default
Not declared
Starter value
Grid

Captions
captions

Input
Choice
Required
No
Choices
Below the image (default) (below); Overlay title on hover (overlay)
Field default
Not declared
Starter value
Not set

Image size served (declared by the source)
imageSize

Input
Choice
Required
No
Choices
Thumbnail (150×150 crop) (thumbnail); Medium (≤300px) (medium); Medium-large (≤768px) (medium_large); Large (≤1024px) (large); Full size (full)
Field default
Not declared
Starter value
Not set

Image corner radius (declared by the source, e.g. 0px 0px 0px 0px)
imageRadius

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image sizing
imageSizing

Input
Choice
Required
No
Choices
Native gallery sizing (default) (native); Full width with declared proportions and fit (fluid); Declared image height (declared-height)
Field default
Not declared
Starter value
Not set

Image height (auto or pixels, e.g. 240px)
imageHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Minimum image height (auto or pixels)
imageMinHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Maximum image height (none or pixels)
imageMaxHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image proportions (auto for natural size, or e.g. 4 / 3)
cardImageAspect

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image position (horizontal and vertical, e.g. 20% 80%)
imagePosition

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image fit
cardImageFit

Input
Choice
Required
No
Choices
Fill (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down)
Field default
Not declared
Starter value
Not set

Slides per view (carousel)
slidesPerView

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Source viewport ranges
responsiveProfile

Input
Source viewport ranges
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Carousel layout at a viewport cutoff
carouselBreakpointMode

Input
Choice
Required
No
Choices
Keep the smaller layout at the cutoff (default) (max-width); Start the larger layout at the cutoff (min-width)
Field default
Not declared
Starter value
Not set

Slides per view, tablet (carousel)
slidesPerViewTablet

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Slides per view, mobile (carousel)
slidesPerViewMobile

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Carousel slide position (declared by the source)
carouselAlignment

Input
Choice
Required
No
Choices
At the start of the strip (start); Centred, its neighbours peeking on both sides (center)
Field default
Not declared
Starter value
Not set

Space between slides (carousel, declared by the source, e.g. 0px)
slideGap

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Space between slides, tablet (carousel)
slideGapTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Space between slides, mobile (carousel)
slideGapMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Images sit inline on the text baseline (the source builder’s carousel anatomy)
imageInline

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Grid columns
columns

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Carousel autoplay interval (ms; empty = off)
autoplayMs

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Carousel controls
carouselNavigation

Input
Choice
Required
No
Choices
Arrows and dots (both); Arrows only (arrows); Dots only (dots); None (none)
Field default
Not declared
Starter value
Not set

Carousel loops (declared by the source; Elementor infinite)
loop

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Slides per step (carousel)
slidesToScroll

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Slides per step, tablet (carousel)
slidesToScrollTablet

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Slides per step, mobile (carousel)
slidesToScrollMobile

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Open full size on click
lightbox

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Yes
Starter value
Not set

Images
images

Input
List of entries
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Empty list

Image URL
images[].url

Input
Picture
Required
Yes
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Alt text
images[].alt

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Picture fit
images[].fit

Input
Choice
Required
No
Choices
Show the whole picture (whole); Fill the frame (fill)
Field default
Show the whole picture
Starter value
Not set

Caption
images[].caption

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image width attribute
images[].width

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image height attribute
images[].height

Input
Number
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Image loading (declared by the source; absence means eager)
images[].loading

Input
Choice
Required
No
Choices
Eager (loads immediately) (eager); Lazy (loads once scrolled into view) (lazy)
Field default
Not declared
Starter value
Not set

Image decoding (declared by the source)
images[].decoding

Input
Choice
Required
No
Choices
Async (async); Sync (sync); Auto (auto)
Field default
Not declared
Starter value
Not set

Image fetch priority (declared by the source)
images[].fetchPriority

Input
Choice
Required
No
Choices
High (high); Low (low); Auto (auto)
Field default
Not declared
Starter value
Not set

This image’s corner radius
images[].imageRadius

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s sizing
images[].imageSizing

Input
Choice
Required
No
Choices
Use gallery setting (gallery); Full width, automatic height (fluid); Declared image height (declared-height)
Field default
Not declared
Starter value
Not set

This image’s height (auto or pixels, e.g. 240px)
images[].imageHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s minimum height (auto or pixels)
images[].imageMinHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s maximum height (none or pixels)
images[].imageMaxHeight

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s proportions (auto or width / height)
images[].aspectRatio

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s fit
images[].objectFit

Input
Choice
Required
No
Choices
Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down)
Field default
Not declared
Starter value
Not set

This image’s crop position (horizontal% vertical%)
images[].objectPosition

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s corner radius, tablet
images[].imageRadiusTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s corner radius, mobile
images[].imageRadiusMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s height, tablet (auto or pixels)
images[].imageHeightTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s height, mobile (auto or pixels)
images[].imageHeightMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s minimum height, tablet (auto or pixels)
images[].imageMinHeightTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s maximum height, tablet (none or pixels)
images[].imageMaxHeightTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s minimum height, mobile (auto or pixels)
images[].imageMinHeightMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s maximum height, mobile (none or pixels)
images[].imageMaxHeightMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s proportions, tablet
images[].aspectRatioTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s proportions, mobile
images[].aspectRatioMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s fit, tablet
images[].objectFitTablet

Input
Choice
Required
No
Choices
Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down)
Field default
Not declared
Starter value
Not set

This image’s fit, mobile
images[].objectFitMobile

Input
Choice
Required
No
Choices
Stretch (fill); Contain (contain); Cover (cover); Original size (none); Scale down (scale-down)
Field default
Not declared
Starter value
Not set

This image’s crop position, tablet (horizontal% vertical%)
images[].objectPositionTablet

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

This image’s crop position, mobile (horizontal% vertical%)
images[].objectPositionMobile

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Spotlight (spans 2x2 in the grid)
images[].span

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Compare image (the “after” frame)
images[].compareUrl

Input
Picture
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Compare image alt text
images[].compareAlt

Input
Text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Registered renditions (stamped at import; JSON of size → file)
images[].renditions

Input
Picture
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

A player for a video file hosted on this site, with supporting text. Without a selected file, it draws no public player. For an outside provider, use the Video element, whose content is not protected by this site’s paywall.

Also carries: Advanced fields, Appearance fields. See shared fields.

Field Input Required Choices Field default Starter value
Name
label
Formatted text No No fixed list Not declared Starter text
Video file
assetId
File No No fixed list Not declared Not set
Poster image
posterAssetId
File No No fixed list Not declared Not set
Caption
caption
Formatted text No No fixed list Not declared Not set
Original video address (from the migrated site)
sourceUrl
Link No No fixed list Not declared Not set
Play automatically
autoplay
Yes or no No No fixed list Not declared No
Start muted
muted
Yes or no No No fixed list Not declared No
Loop
loop
Yes or no No No fixed list Not declared No
Section number
pxLabelNumber
Formatted text No No fixed list Not declared Not set
Section label
pxLabel
Formatted text No No fixed list Not declared Not set

Name
label

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Starter text

Video file
assetId

Input
File
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Poster image
posterAssetId

Input
File
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Caption
caption

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Original video address (from the migrated site)
sourceUrl

Input
Link
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Play automatically
autoplay

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
No

Start muted
muted

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
No

Loop
loop

Input
Yes or no
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
No

Section number
pxLabelNumber

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Section label
pxLabel

Input
Formatted text
Required
No
Choices
No fixed list
Field default
Not declared
Starter value
Not set

Video file is chosen from the media library.

Poster image is chosen from the media library.

Browse section families

Return to the Composer, select the section and review its editable fields. Apply your draft change and inspect the page preview before publishing.