Source: https://docs.amadalis.ai/reference/sections/media/

# Media reference

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](https://docs.amadalis.ai/reference/sections/common-fields/) 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](https://docs.amadalis.ai/reference/sections/common-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.

## Gallery

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](https://docs.amadalis.ai/reference/sections/common-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 |

## Video

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](https://docs.amadalis.ai/reference/sections/elements/#video), whose content is not protected by this site’s paywall.

Also carries: Advanced fields, Appearance fields. See [shared fields](https://docs.amadalis.ai/reference/sections/common-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 |

**Video file** is chosen from the media library.

**Poster image** is chosen from the media library.

[Browse section families](https://docs.amadalis.ai/reference/sections/)

## Your next step

Return to [the Composer](https://docs.amadalis.ai/composer/composer/#select-and-edit-a-section), select the section and review its editable fields. Apply your draft change and inspect the page preview before publishing.