# Set up a hero section

Add a large banner with a headline, background, and button to the top of a page.

Audience: dealer-staff
Availability: available
Canonical source: https://rooftoprv.com/docs/set-up-a-hero-section

A hero is the large banner at the top of a page, with a headline over a color or a photo. Most dealers use one on the homepage. For rotating photos, a video background, and a second button, see [Make your homepage stand out](https://rooftoprv.com/docs/make-your-homepage-stand-out).

## Before you start

- You need the **View website admin** permission to open the page editor.
- You need the **Edit pages and blog posts** permission to save your changes.
- Open the page from **Website** > **Pages**.
- The editor shows a simpler hero than your live site. Check the live page after you publish.

## Add a hero and write its text

1. Select the spot at the top of the page.
2. Select **Insert** > **Hero section**. On a phone, **Insert** is the plus icon.
   A hero appears with the headline "Welcome" and an empty line under it.
3. Select the headline and type your own.
4. To add a line under it, select **Subheadline...** and type.
5. Select the hero.
6. Choose **Align left**, **Center**, or **Align right** from the icons at its top left.
   A new hero is centered.
7. Select **Save & publish** on a draft page, or **Publish changes** on a published one.

The headline is the page's main heading. When a page starts with a hero, your site doesn't show the page's title anywhere on the page. Put the page's name in the headline.

## Choose the background

> **Warning:** If you choose **Image**, upload a photo. Without one, the editor still shows a colored banner, but your live site shows no background at all. White text disappears against your page. Upload a photo, or choose **Gradient** or **Solid**.

1. Select the hero.
2. Select the gear icon at its top left to open its settings.
3. Under **Background**, choose one:

| Background | What you set |
|---|---|
| **Gradient** | Three colors, **From**, **Via**, and **To**, that blend from the top left to the bottom right. New heroes start here |
| **Solid** | One **Background color** |
| **Image** | A **Background image (desktop)**, 1920 by 1080 pixels recommended, and an optional **Background image (mobile)**, 750 by 1000 recommended, for narrow screens |

4. For an image, select **Upload** under each image and pick a file.
   The file must be a JPEG, PNG, GIF, or WebP of 5 MB or less. **Image uploaded** confirms it.
5. For an image, set **Horizontal position** and **Vertical position**.
   They keep the important part of the photo in view when the banner crops it.
6. For an image, keep **Background overlay** on to darken the photo behind your text.
7. Drag **Opacity** from 0 to 100. It starts at 20%.

## Set the height and text color

1. Under **Height**, choose **Small**, **Medium**, **Large**, or **Extra large**.
   New heroes are **Medium**.
2. Under **Text color**, pick a **Light mode** color. It starts white.
3. If your site offers dark mode, you can pick a separate **Dark mode** color.
   Otherwise dark mode uses the light mode color.

## Add a button

The button only shows on your site when it has both text and a link.

1. Under **Call to action**, enter the **Button text**.
2. Enter the **Link URL**, such as `/inventory`.
3. Choose a **Button style**: **White**, or **Accent** to use your site's accent color.
4. Choose a **Button size**: **Small**, **Medium**, or **Large**.

## Add a search bar

> **Warning:** Turning off **Enable search** doesn't remove a search bar already in a hero. Your live site keeps showing it, and the editor hides the switch. Turn off **Show search bar** in each hero and publish before you turn off **Enable search**. If it's already off, turn it back on to reach the switch.

The **Search** settings only appear while **Enable search** is on under **Website** > **Components** > **Search**.

1. Under **Search**, turn on **Show search bar**.
   Shoppers get a field that says "Search inventory..." under your headline.
2. Under **Search bar rounding**, choose **Branding default** or **Fully rounded**.

## Add links along the bottom

These small links sit centered along the bottom edge. Fill in both the text and the link. A link with no text shows nothing on your site.

1. Under **Secondary links**, select **Add link**.
2. Enter the link's text.
3. Enter where it goes, such as `/inventory`.
4. Optional: in the **Badge (optional)** field, enter a short tag that shows beside the link, such as New.
5. Optional: pick a **Link color**.
6. Optional: pick a **Badge color** once the link has a badge.

## Remove a hero

1. Select the hero.
2. Select the X at its top right, labeled **Remove hero**.
3. Publish the page.

## Troubleshooting

**Saving fails with Failed to save page**
You need the **Edit pages and blog posts** permission. Without it you can change the hero on screen, but you can't save.

**My button doesn't show**
It needs both **Button text** and **Link URL**. A button that links to `/concierge` is also hidden while chat is turned off for your site.

**My phone shows a badly cropped photo**
Upload a tall photo under **Background image (mobile)**. Without one, phones crop the desktop photo.

## Related guides

- [Make your homepage stand out](https://rooftoprv.com/docs/make-your-homepage-stand-out)
- [Add and arrange blocks on a page](https://rooftoprv.com/docs/add-and-arrange-blocks-on-a-page)
- [Add your logo and brand colors](https://rooftoprv.com/docs/add-your-logo-and-brand-colors)
