Rich text

Theme section

The Rich text section displays promotional text with custom layout and size, as well as optional images, video player, buttons, and other content and style blocks to design this section to your liking.

This section is great to welcome customers to your store, promotional content of all kinds, announcements, and more. It looks great between two image-focused sections.

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 Rich text.

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

Add headings and text

Edit the Heading, Subheading, and Text blocks to add content to the Rich text section.

STEPS

In your theme editor (Customize):

1. Click the Heading block to change the section title.

   we recommend a short title of just a few words.

   Change the Heading size to Small, Medium, or Large.

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

3. Click the Text block ("Use this text area...") to change the text.

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

   Change the Text size to Small, Regular, or Large.

4. (Optional.) Click (+) Add block to add an Accent block as a mini-heading in all capitals.

5. (Optional.) Click (+) Add block to add multiple Images with custom sizes.

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.

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

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

Add call-to-action button

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 (+) Add block and select Button, then click the new button block.

2. Select or paste a URL for the Link.

3. Change the Link text to display on the button.

   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. Click Save.

Section style and layout

Change the content alignment, width and overall section style.

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 Rich text section to open the settings.

2. Change the Content alignment to align all text content to the Left, Center, or Right of the section.

3. Choose to Enable animation to show visual effects when scrolling, hovering, or interacting with the section.

   Learn more about Section animations.

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

   The Top divider uses the color of Lines and borders set in the Theme settings.

5. Select a Padding option to change the spacing between sections. Choose between Top and bottom, Top only, Bottom only, or set it to None.

6. Set the Content width of the section to Full width or use the slider to use a custom width between 400 - 1000 pixels.

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

Block	Description
Accent	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.

Click the Rich text section to find the following settings.

Section style

Setting	Description
Content alignment	Align all content to the Left, Center, or Right of the section.
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.
Content width	Display the section at Full width or use the slider to set a custom width between 400 - 1000 pixels.

---

Related links

Collapsible row list Image with text Testimonials