Mosaic grid (2 columns)

Theme section

Theme retirement | Context is no longer available on the Shopify theme store. Theme support and updates for current users will end after May 18, 2024. Learn more here.

The Mosaic (2 columns) section displays a flexible collage of feature images and autoplay videos. Mix and match between different size blocks and reorder them to create a promotional feature or lookbook layout.

Add and reorder 4 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 also the Mosaic grid (3 columns) section, which has more block sizes and columns.

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

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

Add mosaic blocks

The Mosaic section has 4 types of mosaic blocks, which range from Small to Large with Square or Rectangular shapes.

Block types include: Small square, Medium rectangle (vertical), Medium rectangle (horizontal), or Large square.

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 blocks

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 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 your [General background color](contrast colors) in your Theme settings.

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

   

Image blocks

Add an image to use for your mosaic blocks. Images 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 image.

STEPS

In your theme editor (Customize):

1. Click on a Mosaic block to open the 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 2050px 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. Change the Media focal point to select what part of the image to center within the block.

   Use this setting to make sure the key part of your image is visible when Media fit is set to Cover.

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.

Add autoplay video

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

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

The autoplay video does not play audio. To embed a single video from YouTube or Vimeo with audio, see Context's 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. Paste the link into the Video link field. Click on the the link that appears in the results above.

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

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

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

For mobile devices, you can choose to display headings within or after the mosaic blocks. Click on the Mosaic block section to change the Content placement for the mobile layout.

STEPS

In your theme editor (Customize):

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

2. (Optional.) Add Small heading text to display above the main heading.

   This heading displays in all capitals. We recommend a short one or two word label.

3. Add Heading text for a title.

   We recommended a short title of just a few words.

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

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

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

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

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

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

2. Select or paste a Link.

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

3. Add Button text to display a button underneath the text block. Leave the Button text 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 border 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.

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.
Small heading	Add mini heading text in all capitals above the heading. We recommended a one or two word label.
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. To learn more, see Shopify's Rich text editor manual.
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.
Overlay 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 on the section to find the following settings:

Setting	Description
Small heading	Enter text to display as a small heading above the main heading.
Heading	Enter heading text to display as a section title.
Subheading	Enter subheading text to display below the heading. Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor manual.
Style	Use the Default or Contrast section style. The Contrast style uses the contrast colors in your Theme Settings.
Heading alignment	Change the alignment of the heading text to Center or Left.
Max width of text	Use the slider to control the maximum width and line breaks of the headings.

---

Related links

Mosaic grid (3 columns) Slideshow