Shape & type
| Setting | Description | Values / Default | Applies to |
|---|---|---|---|
| Border radius | Corner roundness used across the modal: the search field, the filter / sort / grid-layout / “view all” buttons and their dropdowns, the product cards, and the in-card badges (kept slightly rounder than the card). Set to 0 for fully square corners everywhere. | 0–30 px (step 1) · default 10px | Desktop & Mobile |
| Base font size | Base font size for the whole modal. Every other text (headings, labels, results) scales relative to this. An absolute unit (px) stays fixed; a relative unit (em / %) scales with your store’s base font size. Leave empty to inherit your store’s font size. | CSS font size (optional) | Desktop & Mobile |
| Modal font family | Depict: Search & Merchandising only. Font for the modal’s own text and controls, for example Arial, sans-serif. Product cards keep their own card font setting. Leave empty to use your store’s font. | Font family (optional) | Desktop & Mobile |
| Show feedback buttons | Depict: Search & Merchandising only. Show thumbs up / thumbs down buttons under the search results, so shoppers can rate a result set. | On / Off · default On | Desktop & Mobile |
| Match store typography | By default the search field, the suggestions and the chips never drop below 16px, whatever the base font size. Turn this on to let them follow your store’s font size exactly on desktop. On mobile they keep the 16px minimum, which stops phones from zooming in when the field is focused. Small labels keep their accessibility minimums either way. | On / Off · default Off | Desktop (mobile keeps 16px) |
| Section heading style | How the headings above the suggested searches and the top picks are set: small uppercase labels with letter-spacing, or sentence case in the body size. | Small caps, Sentence case · default Small caps | Desktop & Mobile |
Search field
| Setting | Description | Values / Default | Applies to |
|---|---|---|---|
| Search field style | The shape of the search field. Boxed draws a frame around it, filled, with the global border radius. Underline is a single rule under the text, no fill, no radius; the rule darkens while typing. Bare shows only the icon and the text; the icon darkens while typing. | Boxed, Underline, Bare · default Boxed | Desktop & Mobile |
| Surface style | Elevated keeps the soft shadows and glass effects on the field, the filter and sort buttons and the dropdowns. Flat removes them and leaves hairline borders. | Elevated, Flat · default Elevated | Desktop & Mobile |
| Loading indicator | What moves while results load. Gradient around the field runs a light sweep along the field’s frame and blurs the previous results. Thin line under the field draws a 2px line after a short delay and dims the previous results. Quiet only dims the previous results. Underline and bare fields have no frame, so they use the thin line in place of the gradient. | Gradient around the field, Thin line under the field, Quiet · default Gradient around the field | Desktop & Mobile |
Product card
| Setting | Description | Values / Default | Applies to |
|---|---|---|---|
| Text case | Text casing for product card text. | None, Capitalize Each Word, UPPERCASE, lowercase, full-width, Full-size Kana · default None | Desktop & Mobile |
| Font family | Font for product card text. Enter a CSS font-family value, e.g. "Poppins", sans-serif. Leave empty to inherit the modal font. | CSS font-family (optional) | Desktop & Mobile |
| Font size | Font size for product card text. Leave empty to use the Base font size, falling through to your store’s font size when that is also empty. | CSS font size (optional) | Desktop & Mobile |
| Sale price color | Color of the sale price when a product is on sale. Leave empty for the default. | Color (optional) | Desktop & Mobile |
| Original price color | Color of the original (crossed-out) price when a product is on sale. Leave empty for the default. | Color (optional) | Desktop & Mobile |
Modal styling
| Setting | Description | Values / Default | Applies to |
|---|---|---|---|
| Enable dark theme | Applies dark styling to the entire modal. | On / Off · default Off | Desktop & Mobile |
| Background colour | Background of the search modal, its dropdowns, sticky bars and filter panel. Used in light and dark theme alike, so pick a dark colour if dark theme is on. Leave empty for the default. | Color (optional) | Desktop & Mobile |
| Search field colour | Background of the search field, also while typing. Used in light and dark theme alike. Leave empty for the default. | Color (optional) | Desktop & Mobile |
| Custom CSS | Free-form CSS injected globally into the modal, for anything the settings above do not cover. | CSS (optional) | Desktop & Mobile |
Mobile overrides
Phones and tablets up to 979px wide. Leave a field empty to use the desktop value.| Setting | Description | Values / Default | Applies to |
|---|---|---|---|
| Product grid gap on mobile | Spacing between product cards on phones and tablets. Empty uses Product grid gap from the settings embed, at most 12px for the products before the shopper types and 8px for the picks under a no-results message. | Pixels (optional) | Mobile |
| Border radius on mobile | Corner roundness on phones and tablets; 0 is square. | Pixels (optional) | Mobile |
| Product card font size on mobile | Product card text size on phones and tablets, e.g. 13px or 0.9em. | CSS font size (optional) | Mobile |
| Base font size on mobile | Base font size of the modal on phones and tablets, e.g. 15px or 1em. | CSS font size (optional) | Mobile |
A storefront with small type and no shadows, such as a fashion theme set in 14px Helvetica: turn on Match store typography, set Surface style to Flat or Search field style to Underline, set Loading indicator to Thin line, and Section heading style to Sentence case. The heading text itself (“Our Top Picks”) is set in the layout embed.
See also: Adding a way to open the SearchModal in the React SDK guide covers search modal theming when integrating in code.

