# Hero banner ![image](https://docs-assets.foxecom.app/pebble-theme/Fox-BG%20Light%20\(80\)_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.