Skip to main content
The Search template (main-search) controls how search results display, combining products, blog articles, and pages with filtering and customizable metadata display.
Search results page overview

​
What this section controls

  • Product grid layout and density
  • Product filtering and sorting
  • Blog article result display with metadata
  • Page result display options
  • Results per page pagination
  • Label and tag display for mixed results

​
Getting started

1

Open Theme Customizer

In your Shopify admin, go to Online Store > Themes and click Customize on your active theme.
2

Navigate to search page

Use the page selector dropdown to select Search or perform a search on your live site.
3

Locate the template

The “Search” section controls the search results template.

​
Template settings

Control product grid columns on mobile (1-2 products, default: 2).Same as collection page - 2 columns recommended for balanced browsing.
Control product grid columns on desktop (2-4 products, default: 4).4 columns maintains consistency with collection pages and efficient browsing.
Total items (products + articles + pages) before pagination (4-48 items, default: 24).Note: Mixed result types - 24 items might be 20 products, 3 articles, 1 page.

​
Search result types

The search template displays three types of results in mixed format: Products: Displayed in grid matching collection pages, with images and purchase options. Blog articles: Card format with optional metadata (date, author, excerpt, tags). Pages: Simple list format with title, optional excerpt, and “Read more” link. Result ordering: Shopify’s search algorithm determines relevance and ranking across all result types.

​
Best practices

Keep labels enabled

Show “Blog post” and “Page” labels to help users distinguish different content types in mixed results.

Enable article excerpts

Turn on blog excerpt display - helps users quickly determine article relevance from search results.

Match collection settings

Use same product grid settings (4 columns, filtering, sorting) as collection pages for consistency.

Show article metadata

Keep date and author enabled for blog results - provides context about content freshness and source.

Enable page excerpts

Consider enabling page excerpts if you have many pages - helps users identify right page in results.

Test mixed results

Search for terms that return products, articles, and pages to ensure all result types display correctly.

Optimize items per page

24 items balances browsing with performance. Adjust if users frequently paginate or complain about slow loading.

Configure search filters

Use Search & Discovery app to customize which product filters appear on search results.