Image with text

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

---

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

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

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.

Click Image with text section to find settings

Setting	Description
Image	Select an image to display as the feature image. There are no required image dimensions. We recommend a minimum width or height of 2500px.
Image aspect ratio	Choose to crop the primary image to a uniform shape. Select Portrait (2:3), Square (1:1), or Landscape (3:2). Select Natural to display images in their original shape (without cropping). Learn more about aspect ratios in our Image settings guide.
Image focal point	Select the most important part of the image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes. Learn more in our Image settings guide.
Image caption	Enter text to display below the image.

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.

Click Image with text section to find settings

Setting	Description
Show small image	Display an image that overlays the bottom corner of the primary image.
Small image	Select an image to display as the feature image. There are no required image dimensions. We recommend a minimum width or height of 1000px.
Small image aspect ratio	Choose to crop the small image to a uniform shape. Select Portrait (2:3), Square (1:1), or Landscape (3:2). Select Natural to display images in their original shape (without cropping).
Small image focal point	Select the most important part of the 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.

Add content blocks

---

Click (+) Add block to add text and media content to the section. Use the drag handles ⋮⋮ to re-order blocks, and add Spacer and Divider blocks to further customize the layout.

There are three default content blocks: Heading, Subheading, and Button.

Accent

Add text to display a small heading above the main heading.

Heading

Add text to display as a heading.

Text

Add multiple lines of rich text.

Image

Add a small image with an adjustable size.

Button

Add a button link with text.

Video player

Add a video that visitors can click to play in a popup viewer.

Border

Add a border to visually separate other blocks.

Spacer

Add a margin of space between blocks.

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.

File Format	.mp4 video (required)
File size	Maximum 10MB (recommended)
Duration	5 - 10 seconds (recommended)

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.

Change layout

---

Change the position of the featured image and the alignment of the text content.

Click Image with text section to find settings

Setting	Description
Image position	Choose to display the featured image either Left of content or Right of content on desktop screens.
Text alignment	Align the headings and button to the Left, Center, or Right within the text area.

Customize colors

---

Change the colors of the background, text, and button elements.

Click Image with text section to find settings

Setting	Description
Background	Select the color of the section background.
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.

Section style

---

Changethe general section style, including padding and a top divider.

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.

Click Image with text section to find settings

Setting	Description
Enable animation	Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See the Animation guide to learn more.
Top divider	Show a solid border above the section to visually separate it from other sections. The Top divider uses the Lines and borders color selected in the theme color settings.
Padding	Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.

---

Related links

Image hero Image hero split Image with text split Slideshow Grid