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
Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.
Under Template, click (+) Add section and select Image hero.
Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.
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):
Click on the Image hero section to open the section settings.
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.
(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.
Under Image height, choose to 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.
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.
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.
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.
(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.
Click Save
Add video player
Add a short video that customers can click to play within the Image hero section. You need to upload a .mp4 video to your Shopify admin and copy the link into your theme editor settings.
Note | The autoplay video does not play audio. To embed a single video from YouTube or Vimeo with audio, see the Video section.
STEPS
In your Shopify admin:
Go to Content > Files to open your Shopify files.
Click the Upload files button to add your .mp4 file from your computer.
Once your file has been processed, click the Link icon next to the file to copy the URL.
You may need to refresh the page for your file to appear.
In the theme editor (Customize):
Click on the Video player block under the Image hero section.
Paste the link into the Video link field. Click on the the link that appears in the results above.
Click Save.
Customize video player
Once you've added your video, you can add a Preview image, adjust the shape (Aspect ratio), and customize the "Watch now" button.
STEPS
In the theme editor (Customize):
Click on the Video player block to open the video settings.
Upload a Video preview image, ideally a screen capture of the video.
To crop the shape of your preview image, set the Image aspect ratio to Square, Landscape, or Portrait.
The Natural setting will display the original shape of your image.
Change the Button text. The default text is "Watch now."
Change the Button icon style to Dark, Light, or Outline.
Click Save.
Section content
Add section headings
Add a section title and promotional text to overlay your Image hero. The section headings are included as blocks nested within the section.
STEPS
In your theme editor (Customize):
Click the Heading block to change section title.
we recommend a short title of just a few words.
Click the Subheading block to add a few words or short sentence below the heading.
Click the Text block for longer content in a more compact size.
Click (+) Add block to add an Accent block, ideal for a one word label or category.
Click Save.
Add buttons
Add multiple Button blocks to link to your collections or products or any other page with a custom label.
STEPS
In your theme editor (Customize):
Click on a Button block to open the settings.
Click (+) Add block and select Button to add more.
Click Remove block or the eye icon to remove or hide blocks.
Select or paste a URL for the Button link.
Enter text for the Button label.
The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, read "What is a Call to Action?"
(Optional.) Use the drag and drop handles ⋮⋮ to change the position of the Button:
Select a Button style: either Solid, Outline, or Text.
Click on the Image hero section to find the color options for buttons.
Click Save.
Section style
Fine-tune the colors, text position, and padding of the section. You can also add design blocks like the Spacer and Border to refine the look. Click (+) Add block and use the drag handles to move the blocks where you need them.
STEPS
In your theme editor (Customize):
Click on the Image hero section to open the settings.
Change the Text position to align all text content to the Left, Center, or Right of the section.
Select a Padding option to add space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.
Select a Button icon style for the play button: either Dark, Light, or Text.
Click on the Image hero section to find the color options for buttons.
Click Save.
Settings reference
Click the following blocks to find their settings. Click (+) Add block to add new blocks, and use the drag-and-drop handles ⋮⋮ to change their order.
Available blocks
Click the Image hero section to find the following settings.
Add text to display a small heading above the main heading.
Heading
Add text to display as a heading.
Subheading
Add text to display below the heading
Text
Add multiple lines of rich text.
Image
Add a small image with a minimum width of 50px. Select Custom width and use the sliders to set the maximum size in pixels for both desktop and mobile screens.
Button
Add a button with a custom link and label. Change the button style to Solid, Outline, or Text.
Video player
Add a video from your Shopify files, YouTube, or Vimeo. Add a Video preview image with a custom Image aspect ratio. Change the Button text and Button icon style.
Border
Add a horizontal line between blocks.
Spacer
Add a margin of space between blocks.
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.
Image
Select an image to display as the hero image.
There are no required image dimensions. We recommend a minimum width or height of 2500px.
Mobile image
Select an image to display as an hero image for mobile screens.
There are no required image dimensions. We recommend a minimum width or height of 2500px.
Image focal point
Select the most important part of your image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes.
You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our Image settings guide.
Mobile image focal point
Select the most important part of your mobile image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes.
You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our Image settings guide.
Image link
Paste a URL or select a page to make the entire image a clickable link.
Text position
Align all text content to the Left, Center, or Right of the section.
Mobile text position
For mobile devices, align all text content to the Left, Center, or Right of the section.
Text
Enter multiple lines of text.
Button
Select the color of the button background.
Solid button text
If the Solid button style is selected in the button block settings, select the color for the button text.
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.
Enable animation
Choose whether to display visual effects when scrolling, hovering, or interacting with the section.
See the Animation guide to learn more.
Padding
Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.