# Hero banner
_EhDihkXp.jpg)
Open your page with a large image or video and a short message on top, such as a campaign headline and a **Shop now** button. Use it for launches, seasonal sales, or announcements that should be the first thing customers see.
## How to customize the Hero banner section
1. Open the page where you want to display the section in the theme editor by clicking **Edit theme**.
2. Click **Add section**.
3. Select **Hero banner**.
4. Click the **Media** block.
5. Select **Image** or **Video** in **Type**.
6. Click **Select** to add the image or video.
7. Click the **Content** block.
8. Edit the **Text** and **Button** blocks inside **Content**.
9. Click **Save**.
## Section settings
### Layout
| Setting | Description | Options |
| ------------- | -------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Container** | Controls the width of the section content. | **Full:** Uses the available page width.
**Fixed:** Keeps the content within the theme's fixed container width. |
| **Height** | Sets the height of the banner on desktop. | **Adapt to image, Small, Medium,** or **Large**. |
| **Padding** | Sets the space between the banner edges and the content. | **None, Small, Medium, Large,** or **Extra large**. |
### Mobile settings
| Setting | Description | Options |
| ---------- | ---------------------------------------- | ------------------------------- |
| **Height** | Sets the height of the banner on mobile. | **Auto** or **Adapt to image**. |
### Appearance
| Setting | Description | Options |
| ----------------- | ----------------------------------------------------------------------------------------------------------------- | :-------------------------------- |
| **Color scheme** | Applies a theme color scheme to the section. Learn more in [Colors](https://docs.foxecom.com/pebble-theme/theme-settings/colors). | Select an available color scheme. |
| **Corner radius** | Controls how rounded the banner corners appear. | **0–32px**. |
### Padding
Controls the top and bottom spacing separately for desktop and mobile.
| Setting | Description | Options |
| ----------- | ------------------------------------------------------------- | :------------------------- |
| **Devices** | Selects which device-specific padding values you are editing. | **Desktop** or **Mobile**. |
| **Top** | Controls the space above the section content. | **0–100px**. |
| **Bottom** | Controls the space below the section content. | **0–100px**. |
## Blocks
The section includes two built-in blocks: **Media** and **Content**.
### Media
The **Media** block sets the image or video of the banner.
| Setting | Description | Options |
| ------------------- | --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Enable parallax** | Makes the image move slower than the page as customers scroll. | **On** or **Off**. |
| **Type** | Sets the type of media shown in the banner. | **Image** or **Video**. |
| **Image** | Sets the banner image on desktop. Supports JPG, PNG, and WebP. | Select or upload an image, or click **Explore free images**.
*Available when **Type** is set to **Image**.* |
| **Image mobile** | Sets a separate banner image for mobile. | Select or upload an image, or click **Explore free images**.
*Available when **Type** is set to **Image**.* |
| **Video** | Sets the banner video. Supports MP4. | Upload or select a video.
*Available when **Type** is set to **Video**.* |
| **Media overlay** | Adds a color overlay to make the content easier to read. | **On** or **Off**. |
| **Overlay color** | Sets the color of the overlay. | Select a color.
*Available when **Media overlay** is turned on.* |
Turn on **Media overlay** if your image is bright or busy, so the text on top stays easy to read.
### Content
The **Content** block holds the text and buttons shown on top of the banner, and controls where they sit.
#### Content - Layout
| Setting | Description | Options |
| ---------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Alignment** | Sets how the content is aligned inside its box. | **Left, Center,** or **Right**. |
| **Position** | Sets where the content sits on the banner. | **Top left, Top center, Top right, Middle left, Middle center, Middle right, Bottom left, Bottom center,** or **Bottom right**. |
| **Width** | Sets the width of the content box. | **Fit, Fill,** or **Custom**. |
| **Custom width** | Sets the content width as a percentage. | **0–100%**.
*Available when **Width** is set to **Custom**.* |
#### Content - Mobile settings
| Setting | Description | Options |
| -------------------- | ---------------------------------------------------- | ------------------------------- |
| **Alignment mobile** | Sets how the content is aligned on mobile. | **Left, Center,** or **Right**. |
| **Position mobile** | Sets where the content sits on the banner on mobile. | **Top, Middle,** or **Bottom**. |
#### Content - Appearance
| Setting | Description | Options |
| -------------------------- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Inherit color scheme** | Controls whether the content uses the section's color scheme. | **On** or **Off**. |
| **Color scheme** | Sets a separate color scheme for the content. | Select an available color scheme.
*Available when **Inherit color scheme** is turned off.* |
| **Transparent background** | Removes the background of the content box. | **On** or **Off**. |
| **Border** | Adds a border around the content box. | **None** or **Solid**. |
| **Border width** | Controls the thickness of the border. | **0–10px**.
*Available when **Border** is set to **Solid**.* |
| **Border opacity** | Controls the opacity of the border. | **0–100%**.
*Available when **Border** is set to **Solid**.* |
| **Corner radius** | Controls how rounded the content box corners are. | **0–32px**. |
#### Content - Padding and animation
| Setting | Description | Options |
| -------------- | --------------------------------------------------------- | -------------------------------------------------------------------------- |
| **Top** | Sets the space inside the top edge of the content box. | **0–100px**. |
| **Bottom** | Sets the space inside the bottom edge of the content box. | **0–100px**. |
| **Left** | Sets the space inside the left edge of the content box. | **0–100px**. |
| **Right** | Sets the space inside the right edge of the content box. | **0–100px**. |
| **Type** | Sets the entrance animation of the content. | **None, Fade in, Fade up, Slide in (left),** or **Slide in (right)**. |
| **Delay (ms)** | Sets how long to wait before the animation starts. | **0–2000ms**.
*Available when **Type** is not set to **None**.* |
The default **Content** block includes two **Text** blocks, two **Spacer** blocks, and a **Button** block. To add more, click **Add block** inside **Content** and select one of these blocks:
* [**Text**](https://docs.foxecom.com/pebble-theme/theme-blocks/text): Displays a heading, tagline, or paragraph.
* **Spacer**: Adds vertical space between the text and buttons.
* [**Button**](https://docs.foxecom.com/pebble-theme/theme-blocks/button): Displays a call-to-action button.
### Add more blocks
To add a scrolling text ribbon above or below the banner, click **Add block** under the section and select [**Marquee**](https://docs.foxecom.com/pebble-theme/theme-blocks/marquee).
## Tips and best practices
* Use the **Content** block to build a tagline, heading, and button stack, a promotional message, or a row of **Shop now** and **Learn more** buttons.
* Use **Adapt to image** height if your banner has strong visuals and needs a natural crop.
* Add a **Spacer** before or after the heading to create breathing room.
* Add a **Marquee** for seasonal campaigns to add motion and urgency.