Where to find it
In Online Store → Themes, open the unpublished theme editor, choose a compatible template, then Add section → Gallery. Availability follows the selected template and section group.
This section is not available in the Header group.
Set it up
- Add an Image block for each item and select its Image, alt text, heading, caption and optional Link.
- Choose Layout, then set the relevant desktop/tablet/mobile columns and gaps.
- Choose the Default image ratio, overriding Image ratio in a block only where the composition needs it.
- For an editorial composition, review Main image position and Width in grid. Choose whether text appears below, over or separately from images.
- If using carousel autoplay, review its delay and navigation in preview. Configure mobile Grid or Horizontal scroll independently.
Main settings to review
| Setting | Choices or control |
|---|---|
| Layout | Grid · Masonry · Editorial · Carousel · Full-width composition |
| Columns on desktop | 2–5; step 1 |
| Mobile layout | Grid · Horizontal scroll |
| Default image ratio | Adapt to image · Portrait (4:5) · Square (1:1) · Landscape (4:3) |
| Image text | Images only · Below images · Overlay images |
| Autoplay | On / Off |
Blocks and content
This section allows up to 20 direct blocks. Nested blocks have their own parent-specific choices and limits.
- Image: configure this inside the section. Its available controls are listed below.
Content and media
- Use originals suited to each tile size; around 1600 px for a large tile and 1000–1600 px for smaller cards is a starting point.
- This module displays curated media, not live product cards. Use Product showcase when product prices and availability must follow Shopify.
Check the mobile layout
- Mobile layout can preserve a grid or provide horizontal scrolling. Check that the last image and any captions are reachable.
Common questions and fixes
- Image sizes seem inconsistent: review both the section ratio and per-image overrides.
- A product price does not update: an image caption is manual content; replace that area with a product module.
Full control reference
Names, choices, ranges and defaults below are read from this version of the theme. Defaults are starting examples, not promises about your business. Some controls appear only for the matching layout. Block contents and preset starting values can differ from the base defaults.
All section controls (31)
| Setting | Control or choices | Default and guidance |
|---|---|---|
| Width / Section width | Page width · Full width · Custom width | Default: Page width. This control appears only when the relevant layout or related option is selected. |
| Width / Custom width | 50–100 %; step 5 | Default: 80. Percentage of screen width. This control appears only when the relevant layout or related option is selected. |
| Layout / Layout | Grid · Masonry · Editorial · Carousel · Full-width composition | Default: Grid. |
| Layout / Columns on desktop | 2–5; step 1 | Default: 4. This control appears only when the relevant layout or related option is selected. |
| Layout / Columns on tablet | 1–3; step 1 | Default: 2. This control appears only when the relevant layout or related option is selected. |
| Layout / Columns on mobile | 1 · 2 | Default: 1. |
| Layout / Mobile layout | Grid · Horizontal scroll | Default: Horizontal scroll. |
| Layout / Main image position | Left · Right | Default: Left. This control appears only when the relevant layout or related option is selected. |
| Layout / Desktop gap | 0–48 px; step 2 | Default: 16. |
| Layout / Mobile gap | 0–32 px; step 2 | Default: 12. |
| Content / Heading | Text | Default: Gallery. |
| Content / Description | Formatted text | Default: Bring together product details, campaign imagery, or moments from your brand story.. |
| Content / Heading alignment | Left · Center · Right | Default: Left. |
| Carousel / Autoplay | On / Off | Default: Off. This control appears only when the relevant layout or related option is selected. |
| Carousel / Change images every | 3–10 s; step 1 | Default: 5. This control appears only when the relevant layout or related option is selected. |
| Images / Default image ratio | Adapt to image · Portrait (4:5) · Square (1:1) · Landscape (4:3) | Default: Square (1:1). This control appears only when the relevant layout or related option is selected. |
| Images / Image corner radius | 0–40 px; step 2 | Default: 0. |
| Images / Image text | Images only · Below images · Overlay images | Default: Images only. |
| Images / Overlay strength | 10–90 %; step 5 | Default: 60. This control appears only when the relevant layout or related option is selected. |
| Media / Section background image | Choose an image | Default: Not set. |
| Media / Section background position | Image focal point · Top · Center · Bottom | Default: Image focal point. This control appears only when the relevant layout or related option is selected. |
| Media / Section background behavior | Scroll with section · Fixed to viewport | Default: Scroll with section. This control appears only when the relevant layout or related option is selected. |
| Media / Section background overlay | 0–80 %; step 5 | Default: 0. This control appears only when the relevant layout or related option is selected. |
| Style / Color scheme | Choose a color scheme | Default: background. |
| Style / Top padding | 0–160 px; step 4 | Default: 64. |
| Style / Bottom padding | 0–160 px; step 4 | Default: 64. |
| Style / Mobile padding top | 0–100 px; step 4 | Default: 40. |
| Style / Mobile padding bottom | 0–100 px; step 4 | Default: 40. |
| Advanced / Hide on desktop | On / Off | Default: Off. This control appears only when the relevant layout or related option is selected. |
| Advanced / Hide on mobile | On / Off | Default: Off. This control appears only when the relevant layout or related option is selected. |
| Advanced / Section anchor | Text | Default: Not set. Optional. Use a unique name for links that jump to this section. |
Image block controls (8)
| Setting | Control or choices | Default and guidance |
|---|---|---|
| Image | Choose an image | Default: Not set. |
| Image alt text | Text | Default: Not set. |
| Heading | Text | Default: Not set. |
| Caption | Formatted text | Default: Not set. |
| Link | Choose or enter a link | Default: Not set. |
| Image ratio | Use section setting · Adapt to image · Portrait (4:5) · Square (1:1) · Landscape (4:3) | Default: Use section setting. This control appears only when the relevant layout or related option is selected. |
| Width in grid | 1 column · 2 columns · Full row | Default: 1 column. This control appears only when the relevant layout or related option is selected. |
| Text alignment | Left · Center · Right | Default: Left. This control appears only when the relevant layout or related option is selected. |