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

---

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or insert dynamic content with metafields

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 | Animation

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.

STEPS

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 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 ↗ to learn more.

9. Click Save

Click section to find settings

Setting	Description
Image	Select or upload an image to display as the hero image. There are no required images dimensions. We simply recommend uploaded images have a minimum width of 2500px for optimal quality across all devices.
Mobile image	Select or upload an alternate image to display on mobile devices. You may want a different image that works best with mobile screen dimensions, for example a portrait shaped image.
Image link	Select a page or URL to make the entire image a clickable link.
Image focal point	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.
Image height	Display the image with a Custom or the Original height (without cropping). If Custom height is selected: adjust the Height and Mobile Height of your image between 50% to 100% of the maximum height.

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

Setting	Description
Overlay	Select a color to overlay the image. This option helps provide contrast with text and headings to keep them clear and readable.
Overlay gradient	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 ↗ to learn more.
Overlay opacity	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.

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.

Accent

Add small label heading.

Heading

Add title heading.

Text

Add multiple lines of rich text.

Button

Add buttons with custom styles.

Image

Add images with custom sizes.

Video player

Add video that plays in a popup viewer.

Border

Add divider between blocks.

Spacer

Add space between blocks.

Change content layout

---

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

Click section to find settings

Setting	Description
Text position	Change the position of the content blocks within the section for desktop screens.
Mobile text position	Change the position of the content blocks within the section for mobile screens.

Section colors

---

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

Click section to find settings

Setting	Description
Text	Select a custom color for the section text.
Buttons	Select a custom color for the section background.
Solid button text	If the Solid button style is selected in the button block settings, select the color for the button text.

---

Related links

Image hero split Image with text Image with text split Slideshow Video hero