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:
- System › Basic Settings › Search Settings (weights, which sections appear in autocomplete, texts) — configuration for merchants.
- Insights › Analytics › Search & Analytics — reports about search usage in the admin.
Those are separate topics; here we focus on behavior from the shopper's point of view.
Search URL and SEO paths
Many shops use the default path /search for the results page, with the query in the URL as q (for example /search?q=topanky).
Your store can have a custom search path from the SEO settings (the URLs tab, the Search Listing Path field; 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 — the behavior below is the same.
The autocomplete and popular endpoints use the same base path: for example /search/autocomplete and /search/popular with the default settings, or /{your-search-path}/autocomplete and /{your-search-path}/popular with a custom path.
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 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.
The sections shown (such as products vs. categories) and the helper text for "no hits" come from Search Settings in the admin.
Popular items
The storefront can load popular suggestions (products, categories, brands) for an empty search or for discovery. The 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: filters, sorting and the product grid — consistent with the category and all products listings.
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 gives the shopper a clear starting point for browsing.
What you can configure (admin)
In System › Basic Settings › Search Settings you can adjust, among other things:
- How strongly products, categories and brands are weighted in search.
- Which sections appear in autocomplete.
- The placeholder text and the alternatives text when there are no direct hits.
This guide does not replace a detailed description of every field on 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.