Mosaic grid

Theme section

The Mosaic grid (3 columns) section displays a flexible collage of feature blocks with optional images and autoplay videos.

Add and reorder 7 different size blocks to change the layout. Mix and match different types of blocks (solid, image, video) to create an editorial promo or lookbook layout.

See Spark's demo store for an example of a full page Lookbook using the mosaic grid section.

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.

Add headings and text with adjustable alignment and max width. You can remove these headings by leaving the fields blank.

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

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

Add grid blocks

The Mosaic section has 7 types of mosaic blocks, which range from Small to Large with Square or Rectangular shapes. Create different layouts by reordering the blocks with the drag-and-drop handles ⋮⋮ and customize the width and height of each block.

Block types include:

• Small square

• Medium square

• Large square

• Medium rectangle (vertical)

• Medium rectangle (horizontal)

• Large rectangle (vertical)

• Large rectangle (horiztontal).

STEPS

In your theme editor (Customize):

1. Click (+) Add block and select a Block size.

   
2. To create different layouts, mix and match different block sizes and re-order them using the drag-and-drop handles ⋮⋮.

   

   Click Remove block in the block settings to delete a block.

   Click the Eye icon to hide or unhide a block.

3. Click Save.

Solid block

Add a background color to create a solid color block with optional headings and button. You can use a solid block to create a block with headings only.

STEPS

In your theme editor (Customize):

1. Click on a mosaic block to open the block settings.

2. Under Color, click to select a Background color.

   
3. (Optional.) To create a block with Headings only use the color selector to choose the same color as the General background color in the Theme settings.

   Change the Text color to make sure your headings are visible.

4. Click Save.

Image blocks

STEPS

In your theme editor (Customize):

1. Click on a Mosaic block to open the block settings.

   
2. Under Image, click Select Image to choose an uploaded image. Your image will be cropped to fit the size of the block.

   There are no required dimensions. We recommend images with a minimum width of 2500px for optimal quality across devices.

   For Vertical or Horizontal blocks, consider using a rectangular image with a portrait or landscape orientation.

3. Change the Media fit to either have your image Cover the entire block or Contain the image in the block with its original shape.

4. Use Media 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. (Optional.) Select an Overlay color to display overtop of the image and adjust the Overlay opacity using the slider.

   The Overlay lets you control the brightness and tone of images. Use this setting to balance it with other images and to increase contrast with headings so they're readable.

   Set the opacity to 0% to turn off the overlay color; set it to 100% to create a solid color block with no image.

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

7. Click Save.

Video blocks

Add a muted autoplay video to use for your mosaic blocks. Videos will be cropped to fit the block shape: set the Media focal point to position the visible area of the image or change the Media fit to Contain to display the full video.

Add video file

The Video hero section requires an .mp4 that's been uploaded to Content > Files in your Shopify admin. For the best experience, we strongly recommend using a 5 to 10 second video under 10MB.

The autoplay video does not play audio. To embed a video from YouTube or Vimeo with audio, see the Video section.

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 the Video hero section to open the settings.

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

   
3. Change the Media fit to either have your image Cover the entire block or Contain the image in the block with its original shape.

4. (Optional.) Select an Overlay color to display overtop of the video and adjust the Overlay opacity using the slider.

   The Overlay lets you control the brightness and tone of your videoe. Use this setting to balance it with the other images and to add contrast with the headings so they are readable.

5. Click Save.

Add block headings

Each mosaic block can have up to three headings. Adjust the position, width, and color of your headings to match your image or video.

STEPS

In your theme editor (Customize):

1. Click on the Mosaic block to open the block settings.

2. Add Heading text for a title.

   We recommended a short title of just a few words.

3. Add Subheading text to display below the heading.

   We recommend two to three short sentences.

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

4. Use the Text alignment dropdown to change the position of your headings (and button) on the block.

   
5. Use the Max width of text slider to control the maximum width of the headings.

   Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.

6. Select a Text container color to display a color box behind the headings.

   
7. Select a Text color to match your headings to your brand and make sure the text is readable.

   We recommend using WebAIM's contrast checker when matching colors to make sure your text is clear and readable for everyone.

8. Click Save.

Add block button

You can link to your collections or products or any other page. Add Button text to display a button or leave this field blank to make the entire block a clickable link.

STEPS

In your theme editor (Customize):

1. Click on the Mosaic block to open the block settings.

2. Select or paste a Button link.

   Make sure you copy the full URL, including https:// at the start. For example: https://instagram.com/abc123.

3. Add text for the Button label to display a button underneath the text block. Leave the Button label blank to make the entire block 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?"

4. (Optional.) Change the Button text color and Button background color.

   We recommend using WebAIM's contrast checker when matching colors to make sure your text is clear and readable for everyone.

5. Click Save.

Section headings

The Mosaic grid section has multiple headings with adjustable alignment and max width. You can remove these headings by leaving the fields blank.

STEPS

In your theme editor (Customize):

1. Click on the Mosaic grid section to open the settings.

2. Change the Heading text for the section title.

   We recommended a short title of just a few words.

3. Change the Subheading text.

   We recommend two to three short sentences.

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

4. Use the Max width of text slider to control the maximum width of the headings.

   Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.

5. Click Save.

Section style

Customize the section Style with options for section Spacing, Animation, and Alternate section color.

STEPS

In your theme editor (Customize):

1. Click on the section to find the Section style settings.

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

   Learn more about Section animations in Spark.

3. Choose to enable the Alternate section color to apply the secondary section colors selected in your theme settings for colors.

4. Select a Spacing option to add padding around the section content.

   Add padding to either the Top and bottom, Top only, Bottom only, or set it to None.

   
5. Select the Spacing amount for the padded sides of the section: Full, Half, or Minimum.

6. Click Save.

Settings reference

Click on Mosaic blocks to find the following settings.

Setting	Description
Image	Use the Select image button to add an uploaded image. Your image will be cropped and can be adjusted with the Media focal point setting. We recommend uploading an image with a minimum width of 2500px for optimal quality across all devices.
Video link	Add an mp4 video that has been uploaded to your Shopify Files.
Media focal point	Select the Media focal point to control what part of the image or video to center within the block. Use the focal point to make sure the key part of your image or video won't be cropped when it overflows the size of the block.
Heading	Add heading text to display as the block title
Subheading	Add subheading text to display below the heading. Use the formatting buttons to add text styles, links, or lists.
Max width of text	Use the slider to control the maximum width and line breaks of the headings.
Button label	Add custom text for your call-to-action button.
Button link	Select or paste a link for the call-to-action button.
Text alignment	Position the Heading, Subheading, and Button to one of nine quadrants of the block.
Color	Select the text, button, background, and overlay color of the block.
Overlay opacity	Use the slider to adjust the transparency of the overlay color.

Click the Mosaic grid section to find the following settings.

Section content

Setting	Description
Heading	Add text to display as a heading for the section.
Subheading	Add text to display a subheading below the heading.
Max width of text	Use the slider to control the maximum width and line breaks of the section headings.

Section style

Setting	Description
Enable animation	Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See our Section animations to learn more.
Use alternate section color	Apply the alternate section colors as chosen in your Theme Settings. See Spark's theme color settings to learn how to create a secondary color scheme with alternate section colors.
Spacing	Add padding around the section content: either the Top and bottom, Top only, Bottom only, or set it to None.
Spacing amount	Increase or decrease the amount of space around the section: either Full, Half, or Minimum.

---

Related links

Image with text Slideshow\