AI search in the Depict: Search & Merchandising app: how it reaches your theme, what the Search page lets you decide, and the theme-editor settings for how the search modal looks and behaves.
Search in the Depict: Search & Merchandising app is a search modal that opens
from an icon in your theme’s header. It understands what shoppers mean
(“something for a wedding in June”), ranks your catalog with the same signals
as your collections, and shows suggestions and top picks before the shopper
types.Two places hold its configuration:
Where
Decides
Who changes it
The Search page in the app
What search finds and ranks, what shoppers see before typing, what is hidden, and the search reports
You, in the app
Three app embeds and blocks in the Shopify theme editor
How the modal looks and behaves: template, layout, product cards, typography, colours, loading
You, in the theme editor, with Shopify’s live preview
Before you start
Search has to be part of your plan; see Plan.
With search in the plan, the Search page shows a setup guide that walks you
through preparing a preview theme, placing the search button and switching the
embeds on. Theme setup explains what each embed
and block does in your theme.
The Search page
The Search page opens on an overview of the period: revenue via search,
orders, click-through, add to cart, searches that found nothing, and search
conversion, with the queries that need attention. The sections below it hold
the decisions:
Section
Holds
Overview
The period’s numbers and the query worklist.
Queries
Every query of the period with its results, clicks and revenue.
Results & ranking
Which fields search looks at, including the product metafields you make searchable (saving that choice re-indexes your catalog); which filters it offers; search focus (precision against recall); sold-out products; boost & bury rules, either search’s own or the ones your collections use (Use collection rules); and content pages: the store pages, policies and blog posts search can return, with automatic indexing per type, plus custom URLs.
Shopper experience
What shoppers see before typing: the top picks and the suggested queries, the AI suggestions’ tone of voice and blocked terms, and translations of every label the modal shows.
Changes on the Search page are live on your store as soon as they are saved.
Theme-editor settings
The look and behaviour of the modal are set in the Shopify theme editor, so
you see every change in Shopify’s live preview before saving. Open
Shopify admin → Online Store → Themes → Customize, then App embeds
(the puzzle-piece icon in the left sidebar). Three embeds carry the settings:
Depict Search Settings: the template, the product grid and cards, the mobile layout, the headings before typing, and the header logo.
Depict Search Styling: corner radius, typography, the search field’s shape and shadows, the loading indicator, product card fonts and colours, dark theme, background colours, mobile overrides and custom CSS.
Depict Search Layout: the top picks before typing, whether popular searches show, the search bar while scrolling, the column switcher, how close the product grid runs to the panel edge, how many lines product names get, and the search field’s placeholder.
The search button itself is an app block, Depict Search Button, placed in
your header; its own settings (icon, size, optional text) sit on the block.
Depict Search Settings
To edit these settings: Shopify admin → Online Store → Themes → Customize → App embeds, then expand Depict Search Settings.Global settings for how the search modal is laid out and behaves. These are configured once and apply to every search button on your store.
Search template
Setting
Description
Values / Default
Applies to
Search template
How search opens for shoppers. Takeover is the full-screen search. Drawer is a side panel from the header icon; the store stays visible. Quick panel is a centred panel over the store that grows when results arrive. Changing this changes the search experience for every shopper, so preview before saving.
Takeover, Drawer, Quick panel · default Takeover
Desktop (mobile is always full screen)
Drawer side
Drawer template only: the edge the panel slides in from.
Right, Left · default Right
Desktop
Drawer width
Drawer template only: the width of the panel on desktop. Results show two per row inside it.
360–720 px (step 20) · default 560px
Desktop
Product grid
Setting
Description
Values / Default
Applies to
Show products in empty state on mobile
Show product recommendations immediately after opening search on mobile. Exposes more products, but can look crammed alongside the virtual keyboard.
On / Off · default Off
Mobile
Product card minimum size
Minimum width of each product card. The desktop grid fits as many cards as possible while keeping each at least this wide, automatically adjusting the number of columns. Takeover only: the drawer is fixed at two columns and the quick panel at three.
100–450 px (step 10) · default 260px
Desktop
Product grid gap
Spacing between product cards in the grid. On phones, the products shown before the shopper types use this or 12px, whichever is smaller (8px for the picks under a no-results message); the results follow this value. Product grid gap on mobile in the styling embed overrides it on phones and tablets.
Display the discount percentage on products that are on sale.
On / Off · default Off
Desktop & Mobile
Hide product title
Hide the product name on each card.
On / Off · default Off
Desktop & Mobile
Show the colour part of the title on its own line
Show the last colour or print part of a product name on a separate line below the name. Default search cards only.
On / Off · default Off
Desktop & Mobile
Hide product price
Hide the price on each card.
On / Off · default Off
Desktop & Mobile
Red background on sale price
Highlight the price with a red background when the product is on sale. The corners follow the global Border radius (from the styling embed).
On / Off · default Off
Desktop & Mobile
Mobile layout
Setting
Description
Values / Default
Applies to
Mobile search bar position
Where the search input sits on mobile: pinned to the bottom of the screen, or docked at the top under the header. The always visible options keep the search bar and the filter and sort row on screen while scrolling; otherwise both slide away while scrolling down and come back when scrolling up.
Replaces the built-in magnifier shown in the search input field and in result-state messages (e.g. “No exact matches” and “no results”). Best with a simple, square, single-color icon. Leave empty for the default.
Image (optional)
Desktop & Mobile
Suggestions heading
Heading shown above the recommended searches in the suggestions dropdown (the default state, before the shopper types). Leave empty to hide it. Depict: Search & Merchandising only: to hide the recommended searches themselves, turn off Show popular searches in the Depict Search Layout embed.
Text · default Popular searches
Desktop & Mobile
Top picks heading
Heading shown above the recommended products on the search start screen. Leave empty to use the default (“Our Top Picks”, translated automatically per locale). How it is set (small caps or sentence case) is the Section heading style in the styling embed.
Text (optional)
Desktop & Mobile
Header logo
Setting
Description
Values / Default
Applies to
Show logo in search header
Master switch for the logo in the top-left of the search modal. When on, your Shopify brand logo is used unless overridden below.
On / Off · default On
Desktop & Mobile
Logo type
Whether the header logo is an image or a text wordmark.
Image, Text · default Image
Desktop & Mobile
Logo text
Wordmark text shown when Logo type is Text. Defaults to your store name when empty.
Text (optional)
Desktop & Mobile
Text logo font size
Size for the text logo, e.g. 24px or 2em; a bare number is read as px. Leave empty to match the Base font size from the styling embed.
CSS font size (optional)
Desktop & Mobile
Logo image (desktop)
Header logo image on desktop when Logo type is Image. Falls back to your Shopify brand logo (Settings → Brand) when empty.
Image (optional)
Desktop
Logo image (mobile)
Header logo image on mobile when Logo type is Image. Falls back to the desktop logo (or your Shopify brand logo) when empty.
Image (optional)
Mobile
The header logo is clickable: clicking it closes the search overlay, the same as the close (✕) button.
Advanced
Setting
Description
Values / Default
Applies to
Use custom product card
Render a <gpt-search-product-card> custom element instead of the default card. Requires registering the custom element with JavaScript.
On / Off · default Off
Desktop & Mobile
Disable top layer
Enable if you position the modal with custom CSS and need the rest of the page to stay interactive. Watch for z-index issues.
On / Off · default Off
Desktop only
Depict Search Styling
To edit these settings: Shopify admin → Online Store → Themes → Customize → App embeds, then expand Depict Search Styling.Global visual styling of the search modal. The baseline stylesheet has sensible defaults, so the modal still renders correctly if this embed is disabled. Every setting below defaults to the look the modal had before the setting existed, so a store that never touches them sees no change.
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.
Depict Search Layout
To edit these settings: Shopify admin → Online Store → Themes → Customize → App embeds, then expand Depict Search Layout and switch it on.Layout choices for the search start page, scrolling, the results grid, product names and the search field. Every setting defaults to how search looked before the setting existed, so switching the embed on without changing anything changes nothing.
Start page
Setting
Description
Values / Default
Applies to
Top picks columns on desktop
Columns in the top picks grid before the shopper types. Automatic fits up to four to the screen width. Full-screen and search page layouts only; the drawer and the quick panel keep their own grid.
Automatic, 2–6 · default Automatic
Desktop
Top picks columns on phones
Columns in the top picks grid on phones.
1, 2 · default 2
Mobile
Number of top picks
How many products the top picks show. Products pinned in the Depict app come first; the rest follow in the order chosen there.
4–24 · default 6
Desktop & Mobile
Show popular searches
The suggested searches shown before the shopper types. Turn off to leave only the top picks under the search field. Suggestions while typing are not affected.
On / Off · default On
Desktop & Mobile
Scrolling
Setting
Description
Values / Default
Applies to
Hide search bar while scrolling down
Slides the search bar and the results header away while shoppers scroll down the results, and brings them back when they scroll up. Turn off to keep them on screen.
On / Off · default On
Desktop & Mobile
Results
Setting
Description
Values / Default
Applies to
Show column switcher
The buttons above the results that let shoppers pick how many products to show per row. Turn off to always show your default grid.
On / Off · default On
Desktop & Mobile
Product grid side margin
Space between the edge of the search panel and the product images, so the grid can run almost edge to edge. Only the product grid moves; the search field, headings and buttons keep their place. Applies in the drawer and on phones and tablets; the full-screen layout on desktop keeps its margins. Leave empty to line the grid up with the search field.
0–40 px (higher values count as 40) · default empty
Drawer, phones and tablets
Product card
Setting
Description
Values / Default
Applies to
Product name lines
How many lines a product name can use before it is cut off with ”…”. Full name never cuts it off. Applies to the default product card.
1 line, 2 lines, 3 lines, Full name · default 1 line
Desktop & Mobile
Search field
Setting
Description
Values / Default
Applies to
Search field placeholder
The text shown in the empty search field. It replaces the default text in every language, including a placeholder you set under Shopper experience on the Search page. Leave empty to keep those.
Text (optional)
Desktop & Mobile
A grid that runs almost edge to edge, as on many fashion lookbooks: set Product grid side margin to 4 here and Product grid gap to 4 in Depict Search Settings. Phones follow the same gap.
Reports
Search metrics live on the Search tab of the
Analytics page.
Was this page helpful?
Assistant
Responses are generated using AI and may contain mistakes.