Search

Configure product and blog-post search, product filters, sorting, and result columns.

The Search template gives shoppers a dedicated page for finding products and blog posts. Product results use the shared Product card presentation, filters, and sorting. Blog-post results show article images, titles, and summaries.

Open the Search template

Preview more than one query so the result and empty states are both ready.

Open the Theme EditorFrom Shopify admin, go to Online Store > Themes > Edit theme.
Select SearchUse the page selector to open Search, then select the Search section.
Try representative queriesPreview a query with several products, a query with no matching product, and enough results to test pagination.

Products and Blog posts

When a product search also matches blog posts, a Products / Blog posts row appears above the filters. Switching types keeps the keyword and starts from the first page. Blog-post results do not show product filters or sorting.

The Search template with results.

Content

The Content group in the Theme Editor. The values shown are examples, not defaults.

Introduction: Adds rich text below the search heading and above the search form.
Options or default
Use it to explain what shoppers can search or to provide one short prompt for the product results page.

Features

The Features group in the Theme Editor.

Enable filtering: Shows Shopify product filters for a performed search that has results.
Options or default
Enabled by default. Show group name, Show filter values count, and Open first group by default appear only while filtering is enabled.
Show group name: Includes the filter-group name inside selected filters.
Options or default
Enabled by default.
Show filter values count: Shows the available product count beside filter values.
Options or default
Enabled by default.
Open first group by default: Opens the first filter group when the filtering interface first appears.
Options or default
Disabled by default.
Enable sorting: Lets shoppers change the order of product results.
Options or default
Enabled by default.

Results

The Results group in the Theme Editor.

Results per page: Sets the maximum number of results on each page.
Options or default
8–40, in steps of 4. Default: 20.
Results per row (mobile): Sets the mobile result-grid columns.
Options or default
1 or 2. Default: 1.
Results per row (desktop): Sets the desktop product-grid columns.
Options or default
2, 3, or 4. Default: 4.

Blog-post results use three columns on desktop. The mobile column setting and results-per-page setting also apply to blog posts.

Product results use Product card settings, including the configured media, price, badges, ratings, and swatches. The global Product card gap also controls whether space appears between result cards.

The predictive Search drawer remains a separate surface. It can suggest queries and show product or blog-post suggestions before the visitor opens the full results for the selected type.

Spacing

The Spacing group in the Theme Editor.

Section spacing: Sets the overall spacing around the Search section.
Options or default
Small, Medium, or Large. Default: Medium.
Top spacing: Adds space above the Search section.
Options or default
Enabled by default.
Bottom spacing: Adds space below the Search section.
Options or default
Enabled by default.

Search states

When nothing matches, the page keeps the search field so the shopper can try again.

Search results on mobile.

Preview the complete search flow

Use non-sensitive test queries and check the same flow at desktop and mobile sizes.

Before a searchConfirm the heading, introduction, and search form are clear without a result grid.
ResultsCheck product cards, filters, sorting, card gaps, and long product titles.
No resultsMake sure the no-results heading and search form provide an obvious way to try again.
PaginationUse a result set larger than Results per page and test the first, middle, and final pages.

Accessibility and motion

Keep the search field, submit action, filters, sorting controls, pagination, and product links keyboard reachable with visible focus. Verify focus return after closing the mobile filtering interface and confirm that loading or update feedback remains understandable with reduced motion.

Common checks

Symptom	Safe check
Filtering controls are absent	Confirm the search has product results and Enable filtering is on.
A filter group setting is unavailable	Enable Enable filtering first.
Blog posts are not shown in a product search	Select Blog posts above the filters when matching articles are available. Ordinary store pages do not have a dedicated results tab.
Product cards look different from a collection	Review the shared Product card settings and the selected result columns.
Pagination is missing	Confirm the result count exceeds Results per page.