Predictive search
Where you can add it
Not in the Add section list: it comes with its template or section group.
Blocks
Section titled “Blocks”Up to 6 blocks.
Settings
Section titled “Settings”| Setting | Type | Default | Options and range |
|---|---|---|---|
| Layout | |||
| Layout The sheet unfolds out of the header across the page width. The drawer slides in from the side. On phones both open as a sheet. | Select | Sheet from the header | |
| Position End is the side the search icon is on: right in left-to-right languages, left in right-to-left languages. Phones always use the sheet. Shown when Layout is Side drawer. | Select | End | |
| Width Phones always use the sheet. Shown when Layout is Side drawer. | Select | Default | |
| Color scheme | Color scheme | Scheme 1 | |
| Page overlay opacity | Range | 30 % | 0–80 %, step 5 |
| Opening motion How search opens. Full unfolds the sheet out of the header and brings the blocks in one by one; Calm fades it in. Off when Animation is off in Theme settings > Motion, and for customers who prefer reduced motion. | Select | Full | |
| Show the logo The header’s logo, at the start of the search row. Shown when Layout is Sheet from the header. | Checkbox | On | |
| Show “Close” label “Close” and the Esc key on desktop. Off: a round close button. Shown when Layout is Sheet from the header. | Checkbox | On | |
| Search field | |||
| Placeholder text | Text | Search products, pages, or articles | |
| Show field label The label is always available to screen readers. | Checkbox | Off | |
| Keyboard shortcut | Select | Slash (/) and Command/Ctrl + K | |
| Characters before suggestions appear Suggestions start after this many characters. Hebrew matching begins at three characters on most stores. | Range | 2 | 1–3, step 1 |
| Show product type filter Adds a product type dropdown next to the field, using the product types in your catalog. | Checkbox | Off | |
| Results | |||
| Show products | Checkbox | On | |
| Products to show Shown when Show products is on. | Range | 4 | 2–10, step 1 |
| Show collections Available when the customer’s language is supported by Shopify’s predictive search. Hebrew and Arabic stores show products, pages, and blog posts. | Checkbox | On | |
| Collections to show Shown when Show collections is on. | Range | 3 | 1–5, step 1 |
| Show pages | Checkbox | On | |
| Pages to show Shown when Show pages is on. | Range | 3 | 1–5, step 1 |
| Show blog posts | Checkbox | On | |
| Blog posts to show Shown when Show blog posts is on. | Range | 3 | 1–5, step 1 |
| Show search suggestions Query suggestions are available only for stores whose primary language and customer language are English. | Checkbox | On | |
| Suggestions to show Shown when Show search suggestions is on. | Range | 3 | 1–5, step 1 |
| Highlight matching text | Checkbox | On | |
| Show “View all results” | Checkbox | On | |
| Product cards | |||
| Columns on desktop Shown when Show products is on and Layout is Sheet from the header. | Range | 4 | 2–5, step 1 |
| Columns on tablet Shown when Show products is on and Layout is Sheet from the header. | Select | 3 | |
| Results in the drawer and on phones The sheet shows cards from 750 px wide; the drawer and every phone show this layout. Shown when Show products is on. | Select | List | |
| Image ratio Shown when Show products is on. | Select | Portrait | |
| Show add to cart Product cards show quick add, as in collections; adding a product closes search and opens the cart. Rows in the list layout link to the product. Shown when Show products is on. | Checkbox | On | |
| Show vendor Shown when Show products is on. | Checkbox | Off | |
| Show badges Shown when Show products is on. | Checkbox | On | |