Grid

Theme section

The Grid section displays a flexible collage of feature images. Mix and match between different size blocks and reorder them to create a promotional feature 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.

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

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

Add grid blocks

Add Grid blocks with adjustable widths. Create different layouts by reordering the blocks with the drag-and-drop handles ⋮⋮ and customize the width and height of each block.

STEPS

In your theme editor (Customize):

1. Click on a Grid item block to open the settings.

   Click (+) Add item to create new grid blocks.

   Click Remove block or the eye icon to delete or hide a block.

2. Under Background image, click Select Image to select or upload an image.

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

   (Optional.) Select or upload alternate Mobile image that looks best on smaller screen sizes.

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 Image 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. Use the Height and Mobile height sliders to control the maximum height of the grid item.

6. Change the width of the grid item (for desktop screens). Either 100%, 66%, 50%, 33%, or 25%.

7. Use the drag and drop handles ⋮⋮ to change the layout of the mosaic blocks.

   

   Click the Remove block button in the block settings to remove a block.

8. Click Save.

Add block headings

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

STEPS

In your theme editor (Customize):

1. Click on the Grid item block to open the settings.

2. (Optional.) Enter text for an Accent heading in all capitals above the main heading.

   We recommend a short one or two word label.

3. Add Heading text for a title.

   we recommend a short title of just a few words.

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

4. Add Subheading text for a short paragraph.

   We recommend two to three short sentences.

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

5. (Optional.) Add additional Text to display beneath the Subheading.

6. Select a Text position (above) to position your headings (and button) in one of 9 areas of the grid block.

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

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 a Button Label and Link to display a button. Leave the Button label blank to make the entire block a clickable link.

STEPS

In your theme editor (Customize):

1. Click on the Grid item 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. Enter text for a Button label.

   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. Select a Button style: either Solid, Outline, or Text.

5. Click Save.

Block styles

Customize the grid block colors and add either a Overlay color or Overlay gradient over your grid image.

STEPS

In your theme editor (Customize):

1. Click on the Grid item block to open the settings.

2. Under Color, use the color selectors to customize the Background, Text, Buttons, and Sold button text.

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

3. Change the Overlay color and Overlay opacity using the slider to increase the contrast between the text and slide image.

   These settings help make your text clear and readable.

   Set the Opacity to 100% to create a solid color slide. This helps avoid images that include text in the image itself, which are not responsive or recommended.

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

5. Click Save.

Section headings

Add a heading and subheading at the top of the section and choose their alignment.

STEPS

In your theme editor (Customize):

1. Click on the Grid section to open the section settings.

2. Enter Heading text to display a section title.

3. 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 guide ↗.

4. Set the Alignment of the headings to Left, Right, or Center.

5. Click Save.

Section style

Adjust the overall section style by changing the section width, section padding, and grid spacing (between blocks). You can dd an optional Top divider to clearly separate sections.

STEPS

In your theme editor (Customize):

1. Click on the Grid section to open the settings.

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

   Learn more about Section animations in Stiletto.

3. Choose whether to set the Content width of the section to Full width.

4. Use the slider to control the Grid spacing between the blocks.

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

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

7. Click Save.

Settings reference

Click the Grid item block to find the following settings.

Grid item image

Setting	Description
Width	Choose the width of the grid item as a percentage of the section width. Select 100%, 66%, 50%, 33%, or 25%.
Height	Set the maximum height of the grid item in pixels for desktop screens.
Mobile height	Set the maximum height of the grid item in pixels for mobile screens.
Image	Select an image to display as the grid item background. There are no required image dimensions. We recommend a minimum width or height of 2500px.
Media fit	Choose to have the item image Cover the entire block or Contain the image in the block with its original shape.
Image focal point	Select the most important part of the image to keep centered. Use focal points to avoid unwanted cropping across different screen sizes. You can specify a focal point for an image used within a section or for an uploaded image file. Learn more in our Image settings guide.

Grid item content

Setting	Description
Text position	Choose the placement of the headings within the grid item. Select one of nine positions.
Accent	Add text to show a small heading above the main heading.
Heading	Add text to show a main heading.
Heading size	Change the font size of the heading to Small, Medium, or Large.
Subheading	Enter text to display a section subheading below the heading.
Subheading size	Change the font size of the subheading to Small, Medium, or Large.
Text	Add text to show a subheading below the main heading.
Text size	Change the font size of the text to Small, Medium, or Large.
Button link	Select or paste a URL for a button. This link applies to the entire grid item if the button label field is blank.
Button label	Enter text to display as the button label. The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now).
Button style	Choose a style for the button. Select Solid, Outline, or Text.

Click the Grid section to find the following settings.

Section content

Setting	Description
Heading	Add text to show a main heading above the section.
Subheading	Add text to show a subheading below the main heading.
Alignment	Set the position of the section Heading and Text. Either Left, Right, or Center.

Section style

Setting	Description
Enable full width	Choose to display headings as center-aligned within section. Uncheck this option to align headings to the left.
Grid spacing	Increase or decrease the spacing between the grid blocks: between 0 and 50 pixels.
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.

\

---

Related links

Collection list grid Featured collection grid Gallery carousel Multi-column