Search overlay config
Trending terms, included resource types, predictive results limits.
Updated 2026-05-09
Theme settings → Search.
| Setting | Notes |
|---|---|
| Search mode | overlay (default) / inline (header has a visible input instead of icon) |
Search color scheme (search_color_scheme) | Scheme override for the search overlay UI. Default scheme-1. Use it to give search a different palette without touching the header or page. |
| Trending search terms | Comma-separated list — shown on empty state. Default: Shirt, Knit Top, Skirt, Jacket, Denim. |
Show trending terms (search_show_trending) | Toggle. Honours false correctly (a previous Liquid default: true bug treated false as empty — fixed). |
| Show featured collection on empty state | Picker for which collection to highlight |
Show badges in results (search_show_badges) | Toggle. Same false-handling fix as above. |
| Resource types | Toggles: search_include_products, search_include_collections, search_include_articles, search_include_pages |
| Max products / collections / articles / pages | Limits per type in the predictive results |
| Show vendor / price on product results | Toggles |
| Show review stars on product results | Toggle (requires reviews metafield) |
Trending terms
Type 3–8 single-word terms separated by commas. They render as clickable pills under the input. Clicking a pill triggers a search for that term.
Tip: rotate trending terms seasonally — match what your homepage promotes.
Predictive search
Uses Shopify's /search/suggest.json endpoint. The theme requests results in grouped sections per resource type. The client enforces resources[limit] = Math.max(productLimit, 6, 10) — so even if you set a low product max, the predictive endpoint still returns a sensible floor and the merchant can request more products than the default without losing the minimum. Collections / articles / pages use their own configured maxes.
Fix from earlier versions: enabling collections / articles together with a custom product max used to cap products at the wrong number. That's resolved with the formula above.
Enter key
Pressing Enter on the input navigates to /search?q={value} — the full results page. Useful for power users who want filters and pagination.