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 of content and visual design blocks, video player, multiple buttons, and comprehensive image settings.

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.

Set up section

---

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

Section styles

Sections include general styles. Click the section to find options for spacing, and animations.

Section spacing

Section animations

Set up hero image

---

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

STEPS

In your theme editor (Customize):

1. Click the Image hero section to open the 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 2500px for optimal quality across all devices.

3. (Optional.) Upload a Mobile image to display only on mobile devices.

   You can use an alternate image to accommodate for re-sizing, cropping, and heading text on mobile screens. For example, you might use an image with a portrait orientation instead of landscape.

4. Choose to Enable full width to make your image span across the entire screen. Uncheck this option to show margins on both sides of the image.

5. Change the Banner height to set a maximum or fixed height of your image.

   Select Adapt to image to display the full height of your image without cropping. We recommend using this option for square or landscape orientations, so visitors won’t have to scroll down to see the full image.

   Select Custom to set a Custom height for desktop and mobile screens. Choose a Fixed height (in pixels) or Relative height (as a percentage of the window height).

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 setting a focal point for an image used within a section or for an uploaded image file used anywhere on your site.

7. Use the Tint opacity slider to change 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.

   The default Tint color is selected in your theme settings. You can select a custom tint color for this section by following the steps below.

8. Select a Tint style to use either a Solid overlay color or Gradient overlay for the tint.

   The gradient style fades across a range of hues. You can select one of four options to set the angle and direction of the gradient fade.

9. Click Save.

Click Image hero 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.

Change width and height

---

Under Image height, choose to display the image with a Fixed or Relative height.

• Fixed heights maintain the same pixel height on all screens.

• Relative heights adapt the image height as a percentage of the screen height.

Click Image hero section to find settings

Setting	Description	Options
Enable full width	Choose to span the image across the whole window or screen, removing the margins on either side.
Desktop height	Set the section height to a fixed height (in pixels) or relative height (as a percentage of the screen height).	Fixed height 250 - 750px Relative height 50 - 100% Default: 650px
Mobile height	Choose a fixed height (in pixels) or relative height (as a percentage of the screen height).	Fixed height 150 - 750px Relative height 50 - 100% Default: 450px

Change overlay colors

---

When text appears on top of images, sections use Image overlay colors for the text. You can use the default colors from Theme settings > Colors, or select custom colors for the section.

The overlay also applies a tint over top the image. You can use a solid or gradient color, or turn it off.

Overlay colors with high contrast help keep text readable and accessible for everyone.

Solid color with 70% opacity

Gradient color - bottom to top

Click Image hero section to find settings

Setting	Description
Tint opacity	Use the slider to change the transparency of the overlay. Set the opacity to 0% to turn off the tint overlay. Set it to 100% to create a solid color banner.
Tint style	Select a Solid color or Gradient color overlay for the tint. For gradients, select a direction of the fading color.
Override with custom colors	Check this option to use custom overlay colors, instead of the default theme colors.
Text color	Select a custom color for the headings and text.
Tint color	Select a custom overlay color.

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.

Text list with icons

Add column text with icons.

Video player

Add video that plays in a popup viewer.

Divider

Add border between blocks.

Spacer

Add space between blocks.

Change content layout

---

In the section settings, change the width and layout of the content blocks area.

Click Image hero section to find settings

Setting	Description
Content width	Set the maximum width of the section: between 400 and 1000 px.
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.

Show text box

---

Enable the text box to display the content blocks inside a container. Change the text and background colors, and choose to show shadows or borders around the text box.

Soft shadow

Solid shadow

Thick border

Click Image hero section to find settings

Setting	Description
Show text box	Display all content blocks within a container.
Text box style	Display boxes with a Soft drop shadow, Solid drop shadow, or Borders with different thicknesses.
Color scheme	Change the color scheme applied to the text box. Use the Default color scheme from your theme settings or select a variant scheme based on the default: either Inverse, Soft, Accent, or Sale. You can also select a custom color scheme. Learn more.
Override with custom colors	Use custom colors for this section to override the color scheme.
Text color	Select a custom color for text within the text box.
Background color	Select a custom color for the background of text box.

---

Related links Image with content Image with content split Slideshow Video hero