For the complete documentation index, see llms.txt. This page is also available as Markdown.

Image hero split

The Image hero split section provides a highly-customizable feature for your boldest product imagery with two side-by-side hero images. Create a unique section with promotional content, multiple buttons, and comprehensive image settings.


Set up section

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

Click the section to edit general section styles, like colors, width, and padding.

Editing templates change all pages that use that template. For unique pages, use new templates or dynamic metafields

Section style guides


Set up hero images


Upload two Images and fine-tune their Height and Focal point. Add a Mobile-specific image for the best results on smaller screens.

Add image blocks

STEPS

In your theme editor (Customize):

  1. Click on an Image hero split block 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 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. 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.

  5. Enter text for the Heading as a title overlayed on top of the image block.

  6. Enter Text for a subheading beneath the heading to say more. We recommend a short sentence or two.

    Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide.

  7. Select or paste a URL for the Button link.

  8. Enter text for the Button label. If left blank, the entire image will be a clickable link.

    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?"

  9. Select a Button style: either Solid, Outline, or Text.

    Click on the Image hero split section to find the color options for buttons.

  10. Repeat steps 1 - 6 for the second hero image block.

  11. Click Save.

Click image block to find settings

Setting
Description

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.

Heading

Add text to show a main heading.

Text

Add text to show below the main heading.

Button link

Select or paste a URL for a button. This link applies to the entire grid item if the button label field is blank.

Button label

Enter text to display as the button label. The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now).

Button style

Choose a style for the button. Select Solid, Outline, or Text.

Image height

Adjust the height of both hero images.

STEPS

In your theme editor (Customize):

  1. Click on the Image hero split section to open the settings.

  2. Under Image height, choose to display the image with a Custom or the Original height (without cropping).

  3. If Custom height is selected: adjust the Height and Mobile Height of your images 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

  4. Click Save.

Setting
Description

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.

Background image overlay

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

Click section to find settings

Setting
Description

Color scheme

Select a color scheme to apply background and text color. This option helps provide contrast with text and headings to keep them clear and readable.

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.


Related links

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

Last updated