For the complete documentation index, see llms.txt. This page is also available as Markdown.

Grid

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

In the editor side panel, click (+) Add section and select Grid. Use the drag handles ⋮⋮ to re-order sections.

Click the section to edit general section styles, like colors, width, padding, and the section header.

Editing templates change all pages that use that template. For unique pages, use new templates or dynamic metafields

Section style guides


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.

Background media

Support for background videos were added in v5.2.0. View the changelog or learn how to update your theme.

Add an image or autoplay video (without sound) as the grid item's background.

For autoplay videos, make sure your video files meet the following requirements:

Video file type

.mp4 or .mov Embedded YouTube or Vimeo videos are not supported.

Video length

< 15 seconds (Recommended)

Video size

< 10MB (Recommended)

Click Grid item block to find settings

Image

Select or upload an image.

Mobile image

Select or upload an alternate image to display on mobile screens.

Video

Add a short autoplay video (without sound) to replace the image.

Mobile video

Upload an alternate video to display on mobile screens.

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.

Add color overlay

The color overlay adds a layer of color to your image. Overlays help balance image and text for clarity and readability.

Click Item block to find settings

Setting
Description

Color scheme

Select color scheme to apply 'Background' or 'Gradient' colors.

Overlay opacity

Use the slider to change the transparency of the overlay. Set the opacity to 0% to turn off the overlay. Set to 100% to display a solid color (instead of the image).

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.

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.

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 xx-small to Display x-large

Subheading

Enter text to display a section subheading below the heading.

Subheading size

Change the font size of the subheading to xx-small to x-large.

Text

Add text to show a subheading below the main heading.

Text size

Change the font size of the text to xx-small to 5x-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.

Grid spacing


Adjust the grid spacing between blocks for a more compact or spacious layout.

Setting
Description

Grid spacing

Increase or decrease the spacing between the grid blocks: between 0 and 50 pixels.


Related links

Collection list grid Featured collection grid Gallery carousel Multi-column

Last updated