Skip to Content

Search Chat

A chat-style search experience that replaces the traditional search page. Visitors type into an input field and see results appear as conversation-like cards. Includes an idle state with popular search suggestions and a results state with paginated product, article, page, and collection cards.

Configure the Section

This section is used on the Search template. It is already included by default — no manual setup needed.

To customize it, navigate to the Search page in the theme editor and click the Search chat section.

Section Settings

Layout

SettingDescription
Max widthMaximum width of the chat container. Range: 400–900px. Default: 680px.
Container max heightMaximum height of the results area. Range: 400–800px. Default: 600px.
Show borderDisplay a border around the chat container. Default: Off.
Container corner radiusRounded corners on the container. Range: 0–24px. Default: 8px.
Color schemeSelect a color scheme for the section.

Search Input

SettingDescription
Placeholder textText shown in the empty input field. Default: “Search anything”
Input field widthWidth of the input relative to the container. Range: 50–100%. Default: 100%.

Empty State

SettingDescription
TitleHeading shown before any search. Default: “What are you looking for?”
SubtitleOptional subtitle below the title.
Popular searchesComma-separated list of suggested searches shown as pills. Default: “New arrivals, Sale, Best sellers”.
Title styleTypography preset for the title — H1 through H6. Default: H2.
Subtitle font sizeSize of the subtitle text. Range: 12–24px. Default: 16px.

Card Styling

SettingDescription
Border radiusRounded corners on result cards. Range: 0–20px. Default: 8px.
Animation styleHow results appear — Slide up, Fade, or None. Default: Slide up.

Chat Bubble

SettingDescription
Color schemeColor scheme for the search query bubble.
Use custom colorsOverride the scheme with custom background and text colors. Default: Off.
BackgroundCustom bubble background color. Default: #f6f6f6.
Text colorCustom bubble text color. Default: #1a1a1a.

Pills

SettingDescription
Override pill stylingUse custom colors for popular search pills. Default: Off.
Background colorCustom pill background. Default: #F5F5F5.
Text colorCustom pill text. Default: #000000.
Show borderAdd a border to pills. Default: Off.
Border colorCustom pill border color. Default: #000000.

Padding

SettingDescription
PaddingTop, bottom, left, and right padding. Range: 0–100px. Default: 36px.

How It Works

  1. Idle state: The section shows a centered title, optional subtitle, and popular search pills. The input field sits at the bottom.
  2. Search performed: After submitting a query, the input sticks and results appear as cards in the chat area with the selected animation.
  3. Pagination: Results are paginated. The page count is controlled by the global search results per page setting.

Drawer Mode

The same search chat component also powers the search drawer (opened from the header search icon). In drawer mode, the input appears at the top and results scroll downward. Drawer-specific settings are available in the global theme settings under Search.