Image text grid
Complete merchant reference for SAISON's editorial collection grid section: product stream, tile placement, repeat rules, card settings, collection header, swatches, and mobile behavior.
The docs may call this feature Collection grid combinations or Editorial grid, but you edit it in Shopify as Image text grid. Use this reference when you need the exact setting group, recommended value, and common mistake.
Explore the collection grid before changing settings
Click the grid layout, product stream, product cards, editorial tile, promo tile, repeat rule, or mobile behavior. The inspector opens the matching Shopify settings and updates this local mock.
- Set grid columns and spacing.
- Confirm the product stream.
- Tune regular product cards.
- Add one editorial or promo tile.
- Use repeat rules for rhythm.
- Check mobile fallbacks.
For visual combination examples, use the Collection grid combinations guide. For exact schema IDs and defaults across the full theme, use the All Settings Reference.
How Placement Works
| Setting | Location | Recommended | Notes |
|---|---|---|---|
| Product stream | Product grid block | Start with source = collection | Products fill the first available grid cell from left to right. |
| Product placement | Product placement block | Use for index-based hero products | Highest priority for product spans. It styles product 1, 2, 3, and so on after product filtering. |
| Repeat rule | Repeat rule block | Use when a hero should recur | Applies by row and target column, then assigns 1x1, 2x1, 1x2, or 2x2 spans. |
| Product metafield spans | Product metafields custom.grid_span_cols and custom.grid_span_rows | Use only for advanced product-specific layouts | Applied after placement and repeat rules. |
| Manual editorial blocks | Product tile, hero image, hero composition, look tile, promo tile, spacer | Use for fixed content moments | Can use span and placement settings to occupy specific rows or columns. |
| Mobile behavior | Repeat rule and manual tile behavior | fallback_1x1 or full_width | Prevents large desktop features from dominating mobile. |
Image Text Grid Settings
Product Grid Block
Product Placement Block
Product Tile Block
Hero Image And Hero Composition Blocks
Look Tile Block
Promo Tile Block
Repeat Rule Block
Spacer Block
Merchant Troubleshooting
The section is hard to find
In the Shopify editor, look for Image text grid. The docs also call the feature Collection grid combinations because merchants usually think of it by the page it builds.
The wrong product becomes large
Check product source, include tags, exclude tags, and sorting first. Then enable show_grid_overlay and update the product_placement.index value.
The repeat rule does not appear
Confirm the current row and target column match the repeat rule. If a 2-column tile cannot fit at the target column, it may fall back or skip depending on conflict settings.
Mobile feels too tall
Use mobile_behavior = fallback_1x1 on repeat rules and large manual tiles, set columns_mobile = 2, and review mobile_row_height_px.