Storefront search
This guide describes how customers search on your storefront: the search box, suggestions while typing, popular items, and the full search results page. It reflects how the shop application serves search (including default URLs such as /search).
This is not the same as:
- Admin → Search settings (weights, which sections appear in autocomplete, texts) — configuration for merchants.
- Admin → Settings → Search analytics — reports about search usage inside Admin.
Those are separate; here we focus on shopper-facing behavior.
Search URL and SEO paths
Many shops use the default path /search for the full results page, with the query in the URL as q (for example /search?q=shoes).
Your store can use a custom search path from SEO settings (for example a translated segment like /hladat). The storefront and theme link to your configured path automatically. If you changed the path, use the URL shown in the header or search form—behavior below is the same.
Autocomplete and popular endpoints follow the same base path: for example /search/autocomplete and /search/popular with defaults, or /{your-search-path}/autocomplete and /{your-search-path}/popular when the search listing path is customized.
Autocomplete (suggestions while typing)
When someone types in the search field, the shop requests live suggestions (products, categories, brands, and other sections depending on your Search settings).
- With a query: Results match the typed text, within the limits you set in Search settings.
- With an empty field: The shop can show popular products and related items instead of “no results,” so the dropdown is still useful.
Sections shown (such as products vs. categories) and helper text for “no results” come from Search settings in Admin.
Popular items
The storefront can load popular suggestions (products, categories, brands) for empty search or discovery flows. Exact content depends on your catalog and search configuration.
Full search results page
When a shopper runs a full search (submits the form with a non-empty query), they see the product listing experience: filters, sorting, and the product grid—aligned with how category and all products listings work.
If the search query is empty (for example someone opens the search URL without q), the shop redirects to the main product listing (“all products”) instead of showing an empty search page. That keeps a clear starting point for browsing.
What you can configure (Admin)
In Admin → Search settings you can adjust, among other things:
- How strongly products, categories, and brands are weighted in search.
- Which sections appear in autocomplete.
- Placeholder text and alternatives text when there are no direct hits.
This guide does not replace the detailed field-by-field description of that screen; it explains what shoppers experience on the storefront.
Related documentation
- Product listing analytics — how listing grids (including search results) are analyzed for filters and grid engagement.
- Analytics Dashboard — revenue, orders, and store-wide analytics.