Documentation/ Sections /Main search
Contact us
Install
03GENERAL

Main search

This page explains how “Main search” actually behaves, which data it depends on, and what its settings change.

WHAT IT DOES

Main search

This page explains how “Main search” actually behaves, which data it depends on, and what its settings change.

Used in templates
search.json
IMPLICIT BEHAVIOR

What the theme does automatically

  • →

    Results are provided by Shopify search and automatically paginated.

  • →

    Products excluded by the global setting should not appear in product results.

  • →

    Available facets depend on Shopify Search & Discovery.

  • →

    Pagination is calculated by Shopify: the section only loads the configured number of items per page.

  • →

    Available languages, countries, and currencies come from Shopify Markets settings.

CONFIGURATION

Understand the settings

Header

Configure the texts and elements displayed at the top of the section.

Eyebroweyebrow
Titleheading
Texttext
Accessible label of the fieldinput_label
Field textplaceholder
Buttonsearch_label

Results

Adjust the results grid and its display controls.

Results per pageresults_per_page

A higher value loads more results on each page.

Default: 16 · Range: 8–40
Columns on desktopcolumns_desktop
Default: 4 · Range: 2–4
Columns on mobilecolumns_mobile
Default: 2 · Options: 1, 2
Show grid choiceshow_grid_switcher
Default: enabled
Grid choice wordinggrid_switcher_label
Column labelsgrid_columns_label
Meter labelresult_count_label

Content Types

Configure navigation between products, articles and pages as well as their labels.

Navigation labeltype_navigation_label
Allall_results_label
Productsproducts_label
Itemsarticles_label
Pagespages_label
Item badgearticle_type_label
Page badgepage_type_label
Show content excerptsshow_excerpt
Default: enabled
Content linkread_label

Filters and sorting

Activate the filtering and sorting tools, then adapt their presentation and labels.

Enable Shopify filtersenable_filtering
Default: enabled
Enable sortingenable_sorting
Default: enabled
Desktop layoutfilter_layout
Default: horizontal · Options: Horizontal bar, Column on the left, Column on the right
Column widthfilter_sidebar_width
Default: 300 · Range: 240–380px
Keep column visible when scrollingfilter_sidebar_sticky
Default: enabled
Filters buttonfilter_label
Filter titlefilter_heading
Sort labelsort_label
Clear allclear_all_label
Closeclose_label
Minimum priceminimum_label
Maximum pricemaximum_label
Active filtersactive_filters_label
Drawer buttonview_results_label

Use [count].

Product cards

Adjust media, variants, purchase actions and sales signals for product cards.

Media loaded by cardmedia_limit

Limits the number of media loaded per product card.

Default: 2 · Range: 1–5
Navigating between mediaenable_media_slider
Default: enabled
Quick purchaseshow_quick_add
Default: enabled
Quantity selectorshow_quantity_selector
Default: disabled
Color chipsshow_color_swatches
Default: enabled
Material badgeshow_material_badge
Default: enabled
Low stockshow_low_stock
Default: enabled
Product notesshow_reviews
Default: enabled
Universal guideenable_size_guide
Default: enabled
Iconsize_guide_icon
Default: question · Options: Question, Measurements, Care, Materials, Gift, Sparkle, Search, Account, Chat, Bag, Heart, View, More, Check, Star, Quiz, Look
Low stock thresholdlow_stock_threshold

The low stock alert is displayed when the quantity on hand reaches this threshold.

Default: 5 · Range: 1–20
Color option namescolor_option_names

Separate option names used for colors with commas.

Size option namessize_option_names

Separate option names used for sizes with commas.

Quick purchasequick_add_label
Confirm additionconfirm_add_label
Adding in progressadding_label
Product addedadded_label
Add errorerror_label
Product out of stocksold_out_label
Universal guidesize_guide_label
Fallback guidesize_guide_text

Empty state and conversion

Customize the messages and content offered when a search returns no results.

Eyebrow without resultempty_eyebrow
Title without resultempty_heading
Text without resultempty_text

Use [terms].

New searchnew_search_label
Eyebrow before searchdiscovery_eyebrow
Title before searchdiscovery_heading
Text before searchdiscovery_text
Title of popular searchespopular_searches_heading
Recommendation collectionempty_collection
Collection surtitlefeatured_eyebrow
Collection titlefeatured_heading
Link to collectionfeatured_link_label

Pagination and spacing

Customize the section's pagination controls and vertical margins.

Paginationpagination_label
Previous pageprevious_page_label
Next pagenext_page_label
Top marginpadding_top
Default: 40 · Range: 0–120px
Bottom marginpadding_bottom
Default: 80 · Range: 0–120px

Section palette

Applies a consistent palette to the background, text, and buttons in this section.

Section appearance

Use a dedicated paletteopaline_use_color_scheme
Default: disabled
Paletteopaline_color_scheme
Default: scheme-1

Title

Alignment on desktopopaline_heading_alignment
Default: inherit · Options: Keep the design, Left, Center, Right

Spacing

Space after sectionopaline_section_spacing

Creates space between this section and the next. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–160px
Left and right insetopaline_content_inset

Moves content away from the edges. Mobile spacing adjusts automatically.

Default: 0 · Range: 0–120px
COMPOSITION

Available blocks

Popular searchsuggestion
Limit: 8

Add this block only when it provides useful information to the journey.

CHECKS

Before publishing

  • ✓

    Content remains readable in every color scheme.

  • ✓

    Labels match the storefront language.

  • ✓

    Displayed promotions match Shopify rules.

  • ✓

    Interactions remain accessible by keyboard and touch.