# Mosaic grid
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](https://spark-theme-chic.myshopify.com/pages/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.
{% 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/spark/general/editing-themes/using-templates#create-and-assign-multiple-templates) or [insert dynamic content with metafields](https://help.fluorescent.co/spark/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/spark/general/editing-themes/using-templates).
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](https://help.fluorescent.co/spark/theme-styles/colors).
> 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](https://help.fluorescent.co/spark/general/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](https://help.shopify.com/en/manual/online-store/themes/theme-structure/color-scheme#gradients) 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.
{% hint style="info" %}
The autoplay video does not play audio. To embed a video from YouTube or Vimeo with audio, see the [Video section](https://help.fluorescent.co/spark/pages/theme-sections/video).
{% endhint %}
| 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](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. 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](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor).
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](https://webaim.org/resources/contrastchecker/) 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?"](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**.
## 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](https://help.shopify.com/en/manual/shopify-admin/productivity-tools/rich-text-editor#format-text-with-the-rich-text-editor).
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](https://help.fluorescent.co/spark/theme-styles/animation) 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](https://help.fluorescent.co/spark/theme-styles/animation) to learn more. |
| Use alternate section color | Apply the alternate section colors as chosen in your Theme Settings. See Spark's [theme color settings](https://help.fluorescent.co/spark/theme-styles/colors) 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](https://help.fluorescent.co/spark/pages/theme-sections/image-with-text)\
> [Slideshow](https://help.fluorescent.co/spark/pages/theme-sections/slideshow)\\