For the complete documentation index, see llms.txt. This page is also available as Markdown.

Search template

The Search template powers your store's /search page, displaying products, collections, pages, and blog posts that match a customer's query.

Every search query on your store lands on this page. Configure it to match your collection page layout — same grid, same filters, same product cards — so customers get a consistent experience whether they browse or search.

Theme Editor → page selector → Search


Search results

The Search results section controls everything on the /search page: the filter panel, product grid layout, and what appears on each result card.

Filters

Enable filtering and sorting — activates the filter panel and sorting dropdown. The actual filter options (size, color, price range, etc.) are set up separately in the Shopify Search & Discovery app, not in the Theme Editor.

Search filters use the same configuration as collection filters in the Search & Discovery app. If you've already set up filters for your collections, they apply to search results automatically.

Enable availability toggle — adds an "In stock only" toggle above the results, independent of the main filter panel.

Desktop filter style — three options that behave differently depending on the store's navigation layout:

Style
Behavior

Horizontal

Filter bar spans across the top of the grid

Vertical

Filters appear in a sidebar on the left — automatically switches to Drawer in sidebar-based navigation layouts

Drawer

Filters open in a sliding panel. Default on mobile regardless of the desktop setting

Drawer button style — visual style of the filter button: Solid, Outlined, or Link.

Tabs always open — enter filter names (e.g., Size, Color) to keep those tabs permanently expanded in Drawer and Vertical styles. Separate names with commas.

Description of filters with 'AND' operator — adds a short label (e.g., "Match all") explaining to customers that selecting multiple values within a filter shows only products matching all of them. Learn more about AND filter behavior.

Results grid

Infinite scroll — controls navigation at the bottom of the results list:

Mode
Behavior

Disable

Classic numbered pagination

Button

"Load more" button reveals the next batch of results

Auto

True infinite scroll — results load automatically as the customer scrolls

Grid type — Three columns or Four columns.

Grid gap → Custom — switch from Default to Custom to set independent column and row gaps for desktop and mobile separately.

On hover

Controls what happens when a customer hovers over a product card:

Option
Behavior

Second image

Shows the second product image

Slider

Slides through all product images

Hover gallery

Shows a row of image thumbnails below the card

Nothing

No hover interaction

Enable 'Add to cart' button — shows a quick add button on the card. If the product has multiple variants, clicking it opens a Quick View popup for variant selection before adding to cart.

Enable 'Quick view' button — opens a product popup with full details without navigating away from the search page.

Product card

Most settings here mirror the Collection template. Non-obvious ones:

Show short description — displays the product subtitle on the card. Requires setting up the Product subtitle metafield in Admin → Settings → Metafields and metaobjects → Products. See Product subtitle.

Enable color pills — shows color variant swatches directly on the product card. Requires color pills to be configured in Theme Settings → Variant selector.

Show pickup availability — displays in-store pickup status on the product card. Requires retail locations configured in Shopify.

Blog post

Search results include more than just products — blog articles that match the query appear in the same grid alongside products and pages. This is Shopify's native behavior; you can't filter article results separately from product results.

Show image — toggles the article thumbnail on the card.

Show date / Show author / Show number of comments — metadata displayed below the article title on the card.

Last updated

Was this helpful?