Layout search

Block limitations

This is a private block and can only be used within specific parent blocks. It is designed to work exclusively within search templates.

Overview

A block for displaying paginated search results in a customizable grid layout with configurable columns, spacing, and styling. This block supports search result templates with mixed content types (products, articles, pages) and contains provisions for sidebar and top bar filters.

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

• Filter blocks

Block settings

Content

Setting	Description	Options
Items per page	Number of results 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 • Default (default) • XS • SM • MD • LG • XL

Color

Setting	Description	Options
Border color	Controls the border color	• Subtle (default) • Strong

Style

Setting	Description	Options
Border position	Controls which sides have borders	• None (default) • Top • Bottom • Top and bottom

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) • Mobile only • Desktop only