# Image hero

The **Image hero** section provides a highly-customizable feature for your boldest product photos and promotional content. Create a unique section with plenty content and visual design blocks, video player, multiple buttons, and comprehensive image settings.

## Set up section

***

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](/stiletto/general/editing-themes/using-templates.md#create-and-assign-multiple-templates) or [insert dynamic content with metafields](/stiletto/general/adapting-your-theme/dynamic-content-with-metafields.md)
{% endhint %}

In the editor side panel, click **(+) Add section** and select **Image hero**. Click and hold the drag handles **`⋮⋮`** to re-order sections.

Click the section to edit the general **section styles:** [Padding](/stiletto/sections/theme-sections/using-sections.md#section-padding) | [Animation](/stiletto/sections/theme-sections/using-sections.md#section-animations)

## Set up hero image

***

Upload an **Image** and fine-tune its **Height**, **Focal point**, and color **Overlay** or **Gradient**. Add a **Mobile-specific image** for the best results on smaller screens.

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1. Click on the **Image hero** section to open the section settings.
2. Click **Select image** to upload and select an image file.

   > There are no required images dimensions. We simply recommend uploaded images have a minimum width of **`2050px`** for optimal quality across all devices.
3. (*Optional*.) Upload a **Mobile image** to display only on mobile devices.

   > You may want a different image that works best with mobile screen dimensions, for example a portrait shaped image.
4. Under **Image height**, choose to display the image with a **Custom** or the **Original** height (without cropping).
5. If **Custom** height is selected: adjust the **Height** and **Mobile Height** of your image between 50% to 100% of the maximum height.

   > The **Height** is the percentage of the window height on your customer's device.

   > When **Custom height** is set to 50%, the image will always display at half the height of the customer's screen.
6. Use **Image focal points** to specify the main focus of your images. The focal point of your image will remain centered and within frame when your site adapts to different screen sizes.

   > See our [image guide](/stiletto/general/image-guide/theme-image-settings.md#image-focal-point) to learn more about specifying a focal point for an image used within a section or for an uploaded image file when used anywhere on your site.
7. Change the **Overlay color** and **Overlay opacity** using the slider to increase the contrast between the text and image.

   > These settings help make your text clear and readable.
8. (*Optional*) Click the **Overlay gradient** option to add a color overlay that fades across a range of hues.

   > You can choose the style, angle, position, and opacity of the gradient. See Shopify's [color gradient guide](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) to learn more.
9. Click **Save**

</details>

`Click section to find settings`

<table><thead><tr><th width="161">Setting</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:blue;">Image</mark></td><td>Select or upload an image to display as the hero image.<br><br>There are no required images dimensions. We simply recommend uploaded images have a minimum width of <strong><code>2500px</code></strong> for optimal quality across all devices.</td></tr><tr><td><mark style="color:blue;">Mobile image</mark></td><td>Select or upload an alternate image to display on mobile devices.<br><br>You may want a different image that works best with mobile screen dimensions, for example a portrait shaped image.</td></tr><tr><td><mark style="color:blue;">Image link</mark></td><td>Select a page or URL to make the entire image a clickable link.</td></tr><tr><td><mark style="color:blue;">Image focal point</mark></td><td>For desktop and mobile, select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes.</td></tr><tr><td><mark style="color:blue;">Image height</mark></td><td>Display the image with a <strong>Custom</strong> or the <strong>Original</strong> height (without cropping).<br><br>If <strong>Custom</strong> height is selected: adjust the <strong>Height</strong> and <strong>Mobile Height</strong> of your image between 50% to 100% of the maximum height.</td></tr></tbody></table>

### Add color overlay

***

The **overlay** adds a layer of color to your image. Overlays help balance image and text for clarity and readability.

`Click Image hero section to find settings`

<table><thead><tr><th width="163">Setting</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:blue;">Overlay</mark></td><td>Select a color to overlay the image. This option helps provide contrast with text and headings to keep them clear and readable.</td></tr><tr><td><mark style="color:blue;">Overlay gradient</mark></td><td>Add a color overlay that fades across a range of hues. You can choose the style, angle, position, and opacity of the gradient. See Shopify's <a href="https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients">color gradient guide</a> to learn more.</td></tr><tr><td><mark style="color:blue;">Overlay opacity</mark></td><td>Use the slider to adjust the transparency of the overlay color. Set the opacity to 0% to turn off the overlay color. If set to 100%, the overlay will be opaque.</td></tr></tbody></table>

## Add content blocks

***

Use blocks to customize the content area of the section. Click **(+) Add block** to add text, buttons, and other media. Use the drag handles **`⋮⋮`** to re-order blocks, and change the layout in the section settings.

<div><figure><img src="/files/CySklwWxaSRn3gHtNic2" alt="" width="293"><figcaption></figcaption></figure> <figure><img src="/files/ePWVCmf4HT8QaKrfmkhI" alt="" width="375"><figcaption></figcaption></figure></div>

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-type="content-ref"></th></tr></thead><tbody><tr><td><mark style="color:blue;"><strong>Accent</strong></mark></td><td>Add small label heading.</td><td><a href="/pages/5U2s1qKTve492neoD35D#accent">/pages/5U2s1qKTve492neoD35D#accent</a></td></tr><tr><td><mark style="color:blue;"><strong>Heading</strong></mark></td><td>Add title heading.</td><td><a href="/pages/5U2s1qKTve492neoD35D#heading">/pages/5U2s1qKTve492neoD35D#heading</a></td></tr><tr><td><mark style="color:blue;"><strong>Text</strong></mark></td><td>Add multiple lines of rich text.</td><td><a href="/pages/5U2s1qKTve492neoD35D#text">/pages/5U2s1qKTve492neoD35D#text</a></td></tr><tr><td><mark style="color:blue;"><strong>Button</strong></mark></td><td>Add buttons with custom styles.</td><td><a href="/pages/5U2s1qKTve492neoD35D#button">/pages/5U2s1qKTve492neoD35D#button</a></td></tr><tr><td><mark style="color:blue;"><strong>Image</strong></mark></td><td>Add images with custom sizes.</td><td><a href="/pages/5U2s1qKTve492neoD35D#image">/pages/5U2s1qKTve492neoD35D#image</a></td></tr><tr><td><mark style="color:blue;"><strong>Video player</strong></mark></td><td>Add video that plays in a popup viewer.</td><td><a href="/pages/5U2s1qKTve492neoD35D#video-player">/pages/5U2s1qKTve492neoD35D#video-player</a></td></tr><tr><td><mark style="color:blue;"><strong>Border</strong></mark></td><td>Add divider between blocks.</td><td><a href="/pages/5U2s1qKTve492neoD35D#divider">/pages/5U2s1qKTve492neoD35D#divider</a></td></tr><tr><td><mark style="color:blue;"><strong>Spacer</strong></mark></td><td>Add space between blocks.</td><td><a href="/pages/5U2s1qKTve492neoD35D#spacer">/pages/5U2s1qKTve492neoD35D#spacer</a></td></tr></tbody></table>

### Change content layout

***

In the section settings, change the **position** of the content blocks.

`Click section to find settings`

<table><thead><tr><th width="174">Setting</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:blue;">Text position</mark></td><td>Change the position of the content blocks within the section for desktop screens.</td></tr><tr><td><mark style="color:blue;">Mobile text position</mark></td><td>Change the position of the content blocks within the section for mobile screens.</td></tr></tbody></table>

## Section colors

***

Change the general colors of the section. Apply a color scheme or use custom colors.

`Click section to find settings`

<table><thead><tr><th width="150">Setting</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:blue;">Text</mark></td><td>Select a custom color for the section text.</td></tr><tr><td><mark style="color:blue;">Buttons</mark></td><td>Select a custom color for the section background.</td></tr><tr><td><mark style="color:blue;">Solid button text</mark></td><td>If the <strong>Solid</strong> button style is selected in the button block settings, select the color for the button text.</td></tr></tbody></table>

***

> **Related links**
>
> [Image hero split](/stiletto/sections/theme-sections/image-hero-split.md)\
> [Image with text](/stiletto/sections/theme-sections/image-with-text.md)\
> [Image with text split](/stiletto/sections/theme-sections/image-with-text-split.md)\
> [Slideshow](/stiletto/sections/theme-sections/slideshow.md)\
> [Video hero](/stiletto/sections/theme-sections/video-hero.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.fluorescent.co/stiletto/sections/theme-sections/image-hero.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.