Skip to content

Storefront Search

How shoppers search your storefront in plain language, such as compact handgun, or by brand, model, SKU or UPC, how they filter the results, and how to help your products show up

Updated View as Markdown

Your storefront’s search understands what shoppers mean, not just the exact words they type. A shopper can search for compact handgun or red dot for a pistol and find the right products even when those words aren’t in the product names. Searches by brand, model, SKU or UPC work too, and misspelled product names are forgiven.

Search works the same on every store and every theme, with nothing to set up.


What Shoppers Can Search For

Search What it finds
A description, like compact handgun or lightweight AR-15 for home defense Products that match the meaning, from their names, types, descriptions and specifications
A brand and model, like springfield echelon That model, with products matching more of the words first
A misspelled name, like echlon The product it was meant to be
A SKU, UPC or part number That product, even from part of the number
A specification value, like american tactical Products whose specifications mention it, such as their manufacturer

Plain-Language Searches

Searches of two or more words are also matched by meaning, using AI. FirearmCart compares what the shopper typed with each product’s name, product type, brand, description and specification values, so compact handgun also finds subcompact pistols whose names never say “handgun”. These matches are blended with word-for-word matches, and products that match more of the shopper’s words rank higher.

When a Search Finds Little

If a search on the results page finds fewer than three products, AI reads what the shopper meant and searches again with a cleaned-up query. It fixes things like a misspelled brand or a model credited to the wrong maker, and shows the new results when they find more.

What Search Doesn’t Understand

Search doesn’t read prices or stock from what the shopper types. Under $500 searches for those words rather than a price range, so shoppers should use the results page’s Price and Availability filters instead. See Filtering Search Results.


The Search Box and Results Page

Most themes show matching products in a dropdown as the shopper types. Pressing Enter opens the full results page, which lists every match, sorted by Relevance unless the shopper picks price, name or date instead.

  • Products only. Pages, blog posts and collections don’t appear in search results.
  • Active products only. Products that aren’t Active never appear. Sold-out products do.

The search box’s own options, such as whether the dropdown appears, are theme settings in the Visual Editor.


Filtering Search Results

The results page has the same filters as your collection pages, built from the products the search finds, so a shopper can narrow a search for glock to in-stock 9mm magazines in a price range. The count next to each option covers those products.

Filter What shoppers can pick
Availability In stock or Out of stock
Price A price range
Sale On sale, for products whose compare-at price is above their price
In Store In store or Not in store. Shown only when the results include In Store products
Product type One or more product types. Shown when the results span more than one type
Specifications, such as Manufacturer or Caliber / Gauge The values the results carry. Shown for the specifications in your theme’s Collection Filters list (every specification when the list is empty) that have at least two different values among the results

Ticking a second value in the same filter widens the results to either value, and the Product type and specification filters narrow as shoppers pick other filters, the same as on collection pages. A search for holsters shows no Caliber / Gauge filter unless the holsters it finds list calibers.

When a search finds more than 5,000 products, its specification filters appear once the shopper narrows the results below that, for example by product type or price. Every other filter shows from the start.

The filters and the sort menu appear when they’re turned on for your theme’s search page. In the Visual Editor, switch to the search template and check Filters and Sorting on the Search results section, or on its Filtering and sorting block in Horizon, Apex and Tinker.


Search results aren’t reordered by stock. Show out-of-stock products last under Theme Settings > Collection Pages moves sold-out products to the end of collection pages only. Search keeps its relevance order, or the sort the shopper picked, so a sold-out product that matches well still shows near the top. See Collection Pages.


Helping Your Products Show Up

  • Put the important words in the product name. Model, caliber and words such as Compact count for the most there, and the name is the only field where misspellings are forgiven.
  • Add Manufacturer and Brand specifications. Search ranks them as highly as the name. See Specifications.
  • Fill in SKU and Barcode on products and variants, so part-number and UPC searches find them.
  • Write descriptive specification values. Search reads the values, not the names: Threaded Barrel: Yes adds only the word “yes”.
  • Write a description and set the product type. Plain-language searches read both.
  • Keep products Active. Only active products appear in search.

New products and edits appear in search as soon as you save them. Plain-language matching picks up the change within a few minutes.


Navigation

Type to search…

↑↓ navigate↵ selectEsc close