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

# Header 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. This family describes **Hero**, the opening section of a page. For site navigation, use [Menus](https://docs.amadalis.ai/site/menus/).

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.

Eyebrow means the small label above a heading. CTA means call to action, such as a button or link. An avatar is a small portrait or profile image.

## Hero

A headline with supporting words, buttons and optional pictures or video.

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 |
| Open full size on click  
`lightbox` | Yes or no | No | No fixed list | Yes | Not set |
| Eyebrow  
`eyebrow` | Formatted text | No | No fixed list | Not declared | Not set |
| Headline  
`headline` | Formatted text | Yes | No fixed list | Not declared | Starter text |
| Subheadline  
`subheadline` | Formatted text | No | No fixed list | Not declared | Starter text |
| Primary CTA label  
`primaryCtaLabel` | Formatted text | No | No fixed list | Not declared | Starter text |
| Primary CTA URL  
`primaryCtaUrl` | Link | No | No fixed list | Not declared | Empty |
| Secondary CTA label  
`secondaryCtaLabel` | Formatted text | No | No fixed list | Not declared | Not set |
| Secondary CTA URL  
`secondaryCtaUrl` | Link | No | No fixed list | Not declared | Not set |
| Media URL  
`mediaUrl` | Picture | No | No fixed list | Not declared | Not set |
| Picture description (alt text)  
`mediaAlt` | Text | No | No fixed list | Not declared | Not set |
| Video URL  
`videoUrl` | Link | No | No fixed list | Not declared | Not set |
| Video poster  
`posterUrl` | Picture | No | No fixed list | Not declared | Not set |
| Layered media  
`mediaItems` | List of entries | No | No fixed list | Not declared | Not set |
| Image URL  
`mediaItems[].url` | Picture | Yes | No fixed list | Not declared | Not set |
| Alt text  
`mediaItems[].alt` | Text | No | No fixed list | Not declared | Not set |
| Picture fit  
`mediaItems[].fit` | Choice | No | Show the whole picture (`whole`); Fill the frame (`fill`) | Show the whole picture | Not set |
| Source class  
`mediaItems[].className` | Text | No | No fixed list | Not declared | Not set |
| Image width attribute  
`mediaItems[].width` | Number | No | No fixed list | Not declared | Not set |
| Image height attribute  
`mediaItems[].height` | Number | No | No fixed list | Not declared | Not set |
| Image loading (declared by the source; absence means eager)  
`mediaItems[].loading` | Choice | No | Eager (loads immediately) (`eager`); Lazy (loads once scrolled into view) (`lazy`) | Not declared | Not set |
| Image decoding (declared by the source)  
`mediaItems[].decoding` | Choice | No | Async (`async`); Sync (`sync`); Auto (`auto`) | Not declared | Not set |
| Image fetch priority (declared by the source)  
`mediaItems[].fetchPriority` | Choice | No | High (`high`); Low (`low`); Auto (`auto`) | Not declared | Not set |
| Layout  
`layout` | Choice | No | Left (`left`); Centered (`centered`); Split (`split`) | Not declared | Left |
| Band tone  
`tone` | Choice | No | Page canvas (default) (`default`); Primary band (`primary`); Accent band (`accent`); Subtle surface (`surface`); Stage (near black, with glow) (`stage`) | Not declared | Not set |
| Label rule  
`labelRule` | Choice | No | None (`none`); A short rule before the label (`rule`) | Not declared | Not set |
| Lede rule  
`ledeRule` | Choice | No | None (`none`); A rule between the headline and the subheadline (`rule`) | Not declared | Not set |
| Social-proof line  
`proofText` | Formatted text | No | No fixed list | Not declared | Not set |
| Social-proof avatars  
`proofAvatars` | List of entries | No | No fixed list | Not declared | Not set |
| Avatar image  
`proofAvatars[].url` | Picture | Yes | No fixed list | Not declared | Not set |
| Name (alt text)  
`proofAvatars[].alt` | Text | No | No fixed list | Not declared | Not set |

[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.