Searching your store
The online store search is a fully featured, powerful tool for your customers to search across all of your store's products, articles, and pages.
Singular and plural search terms
Searching tries to match terms in both their singular and plural forms.
matches results containing "puppy" or "puppies".
The online store search includes typo tolerance, which finds correct matches for search terms that contain typos.
Search results include matches that differ from the search term by 1 letter or that have 2 letters in a different order. The first 4 letters of a search term need to be entered correctly for typo tolerance to take effect.
Using AND, OR and NOT operators
All search terms are by default AND-ed together, so searching for
yields results containing both "artichoke" and "hearts". Joining operators aren't necessary.
yields results containing at least one of "artichoke" or "hearts".
Searching for results without a term can be done by prefixing the term with a minus sign.
matches terms with "artichoke", but not "heart".
Searching only for certain types
You can restrict the type of objects that get returned by the online store search. For example, you can choose to return products, but not pages or articles.
To only return products you can include the type query parameter like this:
Or to only search for articles and pages with a certain text in the body:
Where type can be any of combination of product, article, and page separated by commas. All three types are searched for if none are specified.
You can do this using a hidden field in the search form within
matches terms that begin with "artich".
Searching specific fields
Add a field name with a colon to your search term to narrow your search for that term to the specified field.
searches for titles that include the term "artichoke".
Searching for a misspelt word won't work when searching specific fields, since search looks for an exact match.
doesn't yield any results.
The following fields are available to use:
Searches for "handle" produce results for exact matches only.
matches a product with the handle "artichoke", but not a product with the handle "artichoke-hearts".
Placing a search term between double quotes (
"") searches for that exact word or phrase in one of the searchable fields.
matches a product with the title "Can of artichoke hearts", but not a product with the title "Canned hearts of artichoke".
The store primary_locale affects which search version you get. For example, searches that match terms in both their singular and plural forms only works for English locales.
Searches with a Japanese locale
For Katakana, Hiragana, and Kanji, search will match any consecutive sequence of at least 3 characters.
For example, you can find "アップルグリーンラップドレス" by searching for any of the following terms:
Kanjis can also be found in pairs of two.
Searching for products, pages, and articles
Products, pages, and articles need to have certain settings in place in order to be searchable.
To make a product searchable, do the following steps:
- Publish your product in the Online Store channel
- Make sure that the product doesn't have a metafield set to
seo hidden, or the product will be hidden from the storefront search
To make a page searchable, do the following steps:
- Publish the page
- Make sure that the page doesn't have a metafield set to
seo hidden, or the page will be hidden from the storefront search
To make an article searchable, do the following steps: