---
title: "Storefront Search"
description: "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"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.firearmcart.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Storefront Search

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](#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](/themes/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/creating-products#the-in-store-specification) 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](/themes/visual-editor#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](/products/collections#filters-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](/themes/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.

---

## Sold-Out Products in Search

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](/themes/visual-editor#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](/products/creating-products#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.

---

## Related Documentation

- [Creating Products](/products/creating-products) - Names, SKUs and specifications
- [Collections](/products/collections) - Filters on collection pages
- [Visual Editor](/themes/visual-editor) - Search results settings, collection filters and theme settings
- [Liquid Variables](/themes/liquid-variables#search) - The `search` object for theme developers

Source: https://docs.firearmcart.com/products/storefront-search/index.mdx
