Image with text

Theme section

The Image with text section combines a feature image with a marketing call to action block. With a flexible layout and optional button, it's a great way to introduce a product collection or something new and exciting.

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.

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

STEPS

In your theme editor (Customize):

  1. Select a Template to edit from the dropdown menu in the top bar.

    Learn how to use templates in our Templates guide.

  2. Under Template, click (+) Add section and select Image with text.

  3. Click and hold the drag-and-drop handles ⋮⋮ to re-order your sections.

Add feature image

Upload a feature image to display on the left or right of the marketing text block. You can adjust the image position, shape, and focal point, and also add an image caption.

STEPS

In your theme editor (Customize):

  1. Click on the Image with text 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. Select an Image aspect ratio to crop your image to Square, Landscape, or Portrait.

    The Natural setting displays the original shape of your 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. Select the Image position to display the image on the Left or Right side of the section.

    The text content will display on the opposite side of the image.

  6. Click Save.

Add small image

The Small image overlays the bottom corner of the feature image. The small image is about 1/4 of the size of the feature, creating a layered, editorial style. It's great for a close-up or detailed photo of your product.

STEPS

In your theme editor (Customize):

  1. Click on the Image with text section to open the settings.

  2. Check the Show small image option.

  3. Under Small image, click Select image to upload and select an image file.

    There are no required images dimensions. We recommend images that are square (1:1) or landscape (3:2) (wider than tall) with a minimum width of 2500px for optimal quality across all devices.

  4. Select an Small image aspect ratio to crop your image to Square, Landscape, or Portrait.

    The Natural setting displays the original shape of your image.

  5. Select the Image focal point to choose which area of the image to keep centered and visible when cropping occurs.

  6. Click Save.

Add video player

Add a short video that customers can click to play within the 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:

  1. Go to Content > Files to open your Shopify files.

  2. Click the Upload files button to add your .mp4 file from your computer.

  3. 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):

  1. Click on the Video player block under the Image with text section.

  2. Paste the link into the Video link field. Click on the the link that appears in the results above.

  3. 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):

  1. Click on the Video player block to open the video settings.

  2. Upload a Video preview image, ideally a screen capture of the video.

  3. 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.

  4. Change the Button text. The default text is "Watch now."

  5. Change the Button icon style to Dark, Light, or Outline.

  6. Click Save.

Section content

Add section headings

Add a section title and promotional text to overlay your feature image. The section headings are included as blocks nested within the section.

STEPS

In your theme editor (Customize):

  1. Click the Heading block to change section title.

    we recommend a short title of just a few words.

  2. Click the Subheading block to add a few words or short sentence below the heading.

  3. Click the Text block for longer content in a more compact size.

  4. Click (+) Add block to add an Accent block, ideal for a one word label or category.

  5. Click on the Image with text section to change the Text alignment of the content blocks. Choose Left, Center, Right.

  6. 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):

  1. 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.

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

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

  4. (Optional.) Use the drag and drop handles ⋮⋮ to change the position of the Button:

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

    Click on the Image with text section to find the color options for buttons.

  6. 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):

  1. Click on the Image with text section to open the settings.

  2. Choose to display a Top divider that separates sections with a Solid line.

  3. 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.

  4. Select a Button icon style for the play button: either Dark, Light, or Text.

    Click on the Image with text section to find the color options for buttons.

  5. Click Save.

Settings reference

The Image with text has three default content blocks: Heading, Subheading, and Button. You can edit or remove these blocks and add 7 other types of blocks to customize the section’s content and layout.

Available blocks

Click the Image with text section to find the following settings.

Layout

Image

Small image

Color

Section style


Related links

Image hero Image hero split Image with text split Slideshow Grid

Last updated