# Mosaic grid (3 columns)
{% hint style="danger" %} 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](https://help.fluorescent.co/context/readme/theme-retirement).
{% endhint %}
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.
## 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.
{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](https://help.fluorescent.co/context/general/editing-themes/using-templates#create-and-assign-multiple-templates) or [insert dynamic content with metafields](https://help.fluorescent.co/context/general/adapting-your-theme/dynamic-content-with-metafields).
{% endhint %}
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](https://help.fluorescent.co/context/general/editing-themes/using-templates).
2. Under **Template**, click **(+) Add section** and select **3 Column Mosaic grid**.
3. Click and hold the drag-and-drop handles **`⋮⋮`** to re-order your sections.
## **Add mosaic blocks**
The Mosaic section has 7 types of **mosaic blocks**, which range from **Small** to **Large** with **Square** or **Rectangular** shapes.
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 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 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 **`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. 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](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) 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) |
{% hint style="info" %}
The autoplay video does not play audio. To embed a single video from YouTube or Vimeo with audio, see the [Video section](https://help.fluorescent.co/context/sections/theme-sections/video).
{% endhint %}
STEPS
In your **Shopify admin**:
1. Go to **Content > Files** to open your [Shopify files](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/file-uploads).
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.
{% hint style="info" %}
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.
{% endhint %}
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](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor).
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](https://webaim.org/resources/contrastchecker/) 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?"](https://www.thebalancesmb.com/call-to-action-1794380)
4. (*Optional*.) Change the **Button text color** and **Button background color**.
> We recommend using WebAIM's [contrast checker](https://webaim.org/resources/contrastchecker/) 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 2050px 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](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor). |
| 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. |
***
> **Related links**
>
> [Mosaic grid (2 columns)](https://help.fluorescent.co/context/sections/theme-sections/mosaic-grid-2-columns)\
> [Image with text](https://help.fluorescent.co/context/sections/theme-sections/image-with-text)\
> [Slideshow](https://help.fluorescent.co/context/sections/theme-sections/slideshow)