Appearance
Search ​
This guide describes how to set up the Search section.
Use the section to set how search results are displayed on the Search page.

The previous image shows an example store's Search page. In the upper left, part of the Theme editor's Search section menu is displayed. The menu's Crop article and page results option is set to Square. This option specifies a cropping style for images within article and page results tiles in the section. For example, in the previous image, a square cropping style is applied to the images in the product page tiles displayed within the section's search results.
For general guidance with modifying sections, refer to Sections overview and Shopify help: Sections and blocks.
Configure the Search section ​
To configure your Search section:
In the Theme editor, at the top of the page, use the dropdown to select Search.
Note
The section is available only on the Search page.
From the side menu, select Search.
Select a setting described in the following table.
| Setting name | Description |
|---|---|
| Display results on cards | Use the Display results on cards option to show or hide a card behind search results in the section. Refer to Shopify help: Cards. |
| Crop article and page results | Use the Crop article and page results option to select No crop, Landscape, Square, or Portrait to set a cropping style for images within article and page results tiles in the section. |
| Results per row on mobile | Use the Results per row on mobile options to select 1 or 2 to set the number of search results to display in each row in the section on mobile display devices. |
| Results per row on desktop | Adjust the Results per row on desktop slider between 2 and 5 to set the number of search results to display in each row in the section on desktop display devices. |
| Filtering > Enable filtering | Use the Enable filtering option to show or hide the filtering options in the section. With this option enabled, your store visitors can access options for applying filtering criteria to their search results. Refer to Shopify help: Add storefront filtering and Shopify help: Searching for products and filtering your product list |
| Filtering > Learn how to set up filters (link) | Follow the Learn how to set up filters link to open the Shopify help: Adding filters with Shopify Search & Discovery page to learn how to set up custom filters for your store. |
| Filtering > Expand filters by default | Use the Expand filters by default option to show or hide the search filtering options in an expanded area, by default, in the section. With this option off, to access the search filtering options, your store visitors must select the Filter button in the section. To use this option, turn on Enable filtering. |
| Filtering > Show filter counts | Use the Show filter counts option to show or hide a count of the number of search results in each filter category in the section. The count is displayed beside the name of each filter. |
| Filtering > Enable price range control | Use the Enable price range control option to show or hide a price range control on the page. With this option enabled, your store's visitors can use the control to specify a minimum and maximum product price. Only products that have a price within the specified price range are displayed on the page. To use this option, turn on Enable filtering. |
| Sorting > Enable sorting | Use the Enable sorting option to show or hide the search sorting options in the section. With this option enabled, your store visitors can arrange the search results by applying sorting criteria. |
| Color > Color scheme | Use the Color scheme picker to select a color scheme for the section. Refer to Colors. |
| Color > Use gradient for background | Use the Use gradient for background option to turn on or off using a gradient as the section's background. |
| Theme settings | If available, select Theme settings to access additional settings for the section. Refer to Section theme settings menu. |
| Custom CSS | Select Custom CSS. In the CSS field, enter custom CSS styles to apply only to the current section. Refer to Shopify help: Add custom CSS. To apply custom styles to your entire online store, refer to Theme settings > Custom CSS. |
Note
To connect a metafield to a setting that supports metafields, select the Connect dynamic source icon displayed beside the setting in the Theme editor.
To learn how to connect a metafield to a supported setting, refer to Shopify help: Connecting metafields to your theme by using the Theme editor.
Configure a block within a Search section ​
To configure a block for your Search section:
In the Theme editor, at the top of the page, use the dropdown to select Search.
From the side menu, expand the Search section menu.
To configure an existing block, select the block from the side menu.
To add a new block, select Add block, choose a block to add, and then select the block you added.
Note
Inside the section, you can add, remove, show, hide, and move blocks. Refer to Configure blocks inside a section and Shopify help: Sections and blocks.
Apply a block setting described in the following table.
| Block name | Block description | Block setting(s) |
|---|---|---|
| Background pattern | Displays a stylistic pattern as a background inside the section. | Refer to Background pattern. |
| Background shape | Displays a stylistic shape as a background inside the section. | Refer to Background shape. |
| Sticker | Overlays the section with a stylized sticker. | Refer to Stickers. |
| Shape divider | Displays a stylized separator between the current section and the next/previous section. | Refer to Shape divider. |