Search
Add customizable predictive search with trending suggestions, branded visuals, and flexible alignment for better product discovery and a seamless user experience across navigation and hero areas.
Last updated 2 months ago
Overview
The Search block provides a predictive search experience within your storefront, allowing users to access suggestions, trending topics, and key promotions directly from navigation or hero areas. With its versatile customization options, you can seamlessly blend search into your branding and streamline how visitors discover content.
💡 Tip: Predictive search helps customers explore content and highlights promotions or collections before they even begin typing.
Input and layout settings
These settings let you define how the search bar is displayed and how visitors interact with it. You can create a minimal icon-only search, a compact input field, or tailor the placeholder and button text for clarity.
Block layout and alignment
Adjust how the Search block fits and aligns in different areas for a consistent, responsive appearance on both desktop and mobile.
Fill available space
Makes the block stretch to occupy its container
Default: off
Desktop alignment
Left (default)
Center
Right
Full width
Mobile alignment
Left (default)
Center
Right
Full width
Predictive search and results settings
Fine-tune how predictive suggestions, trend menus, or features appear when users click the search bar. These settings amplify discoverability and streamline promotion.
📝 Note: Setting up default and secondary results gives curated, campaign-driven exposure within search suggestions.
Show predictive results
Display instant suggestions as visitors type
Default: enabled
Default results
Primary menu shown before users enter a search
Default: main-menu
Show banner
Highlights important content with a banner
Banner background settings
Optimize the banner area using background images or video for both desktop and mobile. These settings allow for immersive brand visuals and can differentiate the search experience across devices.
💡 Tip: Use separate files for mobile and desktop backgrounds to guarantee quick load time and a crisp display.
Background image fit
Contain
Cover (default)
Default
Background image (desktop)
Set a banner image for desktops
Background image (mobile)
Supply a mobile-first image for optimal results
Background video (desktop)
Play a video as the search background on desktops
Background video (mobile)
Offer a separate video background for mobile screens
Banner foreground content
Overlay headlines, captions, icons, and action buttons directly onto your search area to increase engagement and drive users to key messaging or actions.
💡 Tip: Combine foreground headings and calls-to-action to maximize the search area’s impact on page navigation and campaign performance.
Horizontal alignment
Left
Center
Right
Vertical alignment
Top
Center
Bottom (default)
Icon
Place a visual symbol beside your heading or button
Caption
Give context or introduce branding with a short supporting line
Heading
Main headline, drawing attention to search or promotions
Heading size
Extra small
Small
Medium
Large
Extra large
Jumbo
Heading type
Paragraph
H1
H2 (default)
H3
H4
H5
H6
Subheading
Detailed text or secondary call-to-action below the main heading
Button icon
Reinforce your button with an accompanying icon
Button text
Specific label for your call-to-action button
Button link
The page or offer your button directs users to
Open link in a new tab
Launch
thebutton link in a new browser tabDefault: off
Button style
Primary
Secondary
Extra large
Plain
Small
Small secondary
Circle
Button layout
Icon left
Icon right
Icon only
Link style
Button
Full block
Full block with button
Banner foreground media
Enrich the Search block’s impact with images and optional links, creating an engaging, interactive visual centerpiece.
📝 Note: Making the main image clickable can direct attention to products or featured collections.
Image
Add brand graphics or campaign visuals to the foreground
Image style
Default
Rounded corners
Circle
Maximum image width
Choose image width up to 1600px in 16px increments
Default: 160px
Link
Make the image open a page when clicked
Visibility controls
Limit Search block visibility by device. This helps you avoid redundancy or create a focused experience for users on different platforms.
💡 Tip: Use hide-on-mobile or hide-on-desktop options to tailor search utility and reduce distractions on select devices.
Visibility
Do not hide (default) — visible on all devices
Hide on desktop — visible only on mobile
Hide on mobile — visible only on desktop
Available in sections
The Search block can be added in the following sections:
Main navigation
Usage notes
📝 Note: To maximize usability:
Write short, descriptive placeholder text and button labels for accessibility.
Compress image and video assets for optimal speed.
Adjust contrast and overlays for readability and compliance.
Test alignments, button actions, and predictive results across devices to ensure smooth performance.