Skip to content
List collections
Block limitations
This is a private block and can only be used within specific parent blocks. It is designed to work exclusively within collection list templates.
Overview
A block for displaying paginated collections in a customizable grid layout with configurable columns, spacing, and styling. This block supports collection list templates.
Common use cases
- Adjust items_per_page based on your store's needs
- Set appropriate row_desktop and row_mobile values for responsive design
Compatible blocks
The following blocks can be nested within this block:
- Grid paginate item blocks
- Container blocks (for top bar, sidebars, bottom bar)
- Pagination
Block settings
Content
| Setting | Description | Options |
|---|---|---|
| Items per page | Number of collections per page | 1 - 32 (default: 10) |
Spacing
| Setting | Description | Options |
|---|---|---|
| Top spacing | Spacing above the grid | 0 - 300 px (default: 0) |
| Bottom spacing | Spacing below the grid | 0 - 300 px (default: 0) |
| Enable horizontal padding | Adds horizontal padding around the grid | Checkbox (default: false) |
| Gap size | Spacing between grid items | • None |
Color
| Setting | Description | Options |
|---|---|---|
| Border color | Controls the border color | • Subtle (default) |
Style
| Setting | Description | Options |
|---|---|---|
| Border position | Controls which sides have borders | • None (default) |
Layout
| Setting | Description | Options |
|---|---|---|
| Row desktop | Number of columns on desktop | 1 - 8 (default: 5) |
| Row mobile | Number of columns on mobile | 1 - 3 (default: 2) |
| Enable margin | Adds margin around the grid | Checkbox (default: false) |
Display
| Setting | Description | Options |
|---|---|---|
| Visibility | Controls when the block is visible | • All (default) |