# Image banner

<figure><img src="https://3146423938-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZQuVfmt0J7tzTvfBqG6C%2Fuploads%2FUMSLgiGN2VoP5GJp7xer%2FPrimavera%20Distinction%202025-04-01%20at%205.19.53%20pm.jpg?alt=media&#x26;token=a1f2fb9a-0958-44ab-a772-b08186cb4626" alt="An example of an image banner with heading and button blocks on Primavera Distinction."><figcaption><p>Image banner on Primavera Savoir</p></figcaption></figure>

Whether used as a standalone section or as a mix-and-match block in [split banner](https://docs.ultramarinastudios.com/sections/split-banner) or [split card](https://docs.ultramarinastudios.com/sections/split-card), an image banner is essentially an image with [theme blocks](https://docs.ultramarinastudios.com/blocks).

* **Media**: Choose a **desktop image** and, optionally, a **mobile image**
* **Layout**:
  * **Desktop/mobile height**: Choose between **Adapt**, which uses the same aspect ratio as the uploaded image, or one of three fixed sizes, **Small, Medium** and **Large**, for both desktop and mobile.
  * **Stack content**: By default, text content is positioned over the image (the **never** option). When stacked, content will be positioned below the image instead of overlaid. Choose to stack on **mobile** only or **always** to stack on bock desktop and mobile.
  * **Media frame**: Can be used to add a border or frame effect to your image. The background color of this frame inherits from the current color scheme.
  * **Media content padding**: When the text content is overlaid, this setting allows you to choose its spacing from the edge of media. This setting may therefore only be noticeable when the content is aligned to the top/bottom or left/right. **Default** aligns the content to the page width where possible.
* **Colors:**
  * **Enable overlay:** Use this option to improve readability of the text over all screen sizes. Applying a semi-transparent overlay is a great way to ensure both the image and text are visible.
  * **Overlay color**: Choose a linear gradient to apply when the overlay is enabled.

{% hint style="info" %}
Can't find the setting you're looking for?  The following settings are explained in detail in [common settings](https://docs.ultramarinastudios.com/common-settings):

* Container type
* Container width
* Horizontal/vertical alignment
* Enable banner click
* Color scheme/color scheme transition
* Padding
* Borders
  {% endhint %}

### Blocks

All [theme blocks](https://docs.ultramarinastudios.com/blocks/section-blocks/broken-reference) are available to use in this section.