How to Use the Shopify Search & Discovery App

A catalog that outgrows browsing fails quietly. Shoppers scroll past the product they came for, search returns two hundred results in an order nobody chose, and the product page shows whatever Shopify decided to recommend. None of that throws an error, which is why it survives for months.

The Quick Verdict

Find the symptom you actually have, then read the section behind it — or, if you have just installed the app, start with the setup order.

What Does Shopify Search Already Do, and What Does the App Add?

The app is not what gives your store a search box. Shopify draws that line itself on its storefront search page, and it matters because a merchant who installs the app expecting search to start working will find nothing has changed until they configure something.

What the app adds is control. Shopify listed it on the App Store on July 25, 2022 and announced it in the changelog three weeks later, on August 15, 2022 — two dates for two different events, which is why both appear in circulation. The table below separates what you already have from what installing the app puts in your hands.

Shopify Help Center, Storefront search, read September 18, 2026. Quoted phrases are Shopify's own wording for the app's features.

What Do You Need Before You Open the App?

Start with the theme, because it is the only prerequisite you cannot fix inside the app. Shopify is direct about the risk, and adds a detail that catches people out: on a non-supported theme the admin message described just below might not appear at all, so a Collection and search filters section under Content > Menus with no message is not proof that the theme is fine.

The check takes a minute: go to Content > Menus in your admin — if the theme does not support filtering, a message is displayed in the Collection and search filters section. On Shopify-developed themes the on/off setting itself lives in the Product grid section of Collections pages and the Search results section of the Search page.

Three staff permissions govern who can do what, and they are not interchangeable:

• Products — required for editing product recommendations, product boosts and filters.
• Online Store Search and Navigation — required for editing filters.
• Reports — required for viewing analytics.

Two more notes from the same page. Building a custom storefront does not rule the app out: Shopify says you can use its features with the Storefront API.

And a line on that page adds that using this feature requires Shopify Network Intelligence to be enabled in your privacy settings — the page does not spell out which of the app's features that requirement governs, so it is worth checking your privacy settings before you conclude that something is broken.

The app itself installs from its App Store listing — the card at the top of this page links to it.

How to Build Filters Shoppers Actually Use

The first decision is not which filter to build but which layer of the catalog belongs in filters at all. Departments a shopper chooses between usually belong in the menu; attributes they narrow by — size, colour, material, price band — belong in filters, and our navigation guide works through where each layer of a catalog should live.

Once that is settled, the app itself imposes a discipline worth knowing up front. Each filter source can only be used one time for a store's filters: if a Price filter is already active, Price is greyed out and cannot be the source of a second one. You are designing a set, not a list.

Which Filters Can You Build?

Shopify describes custom filters as being based on the product options, metafields, or metaobjects used in your store, including category metafields drawn from its Standard Product Taxonomy. In practice that gives ten places a filter can come from, each with its own catch.

Shopify Help Center, Adding filters with Shopify Search & Discovery, read September 18, 2026. The seven ceilings in the next table come from the same page.

The metafield row is the one that needs planning rather than clicking. Only seven value types can become a filter — single line text and its list form, decimal, integer, true or false, and metaobject reference with its list form — so the value type you choose on the day you create the definition decides whether shoppers can ever filter by it. Our metafields guide covers which definitions qualify and how to make one.

The Seven Ceilings, and What Happens When You Hit One

Every figure read on Shopify's Adding filters page (linked above), September 18, 2026. The highlighted row and the last row are the two that remove filters rather than limiting them.

Two of these numbers look alike and are not the same thing. The 1,000 above is how many values a filter displays inside the app's own screen; a separate troubleshooting section on the same page caps tags at 5,000 unique values and product options and attributes at 1,000, and says only that metafield values might be missing depending on how the metafield is structured. If values are disappearing rather than failing, that second list is where the answer lives.

Why a Filter You Built Never Shows

Work down this list in order — each item names the condition, where you check it in your own store, and what the shopper sees when it applies.

1. The theme does not support filters. Check Content > Menus in your admin, where Shopify displays a message in the Collection and search filters section if the theme does not support filtering. Shopify states that you can still create filters in the app, but they will not be displayed to customers.
2. Filtering was never switched on. On Shopify-developed themes the setting lives in the Product grid section of Collections pages and the Search results section of the Search page; with that setting deactivated, filters are not displayed either.
3. The values have no products behind them. Only filter values that apply to products of a collection or search result display on your store — open the collection itself, not the app.
4. Empty values are set to hide. Shopify notes that a filter is hidden entirely if all of its filter values are empty, so the setting that tidies a filter can also remove it.
5. The shopper switched currency. The price filter does not display when customers select any currency other than your store's default.
6. The shopper switched language. The product tag filter only displays to customers shopping in your store's default language — our FAQ on translating collection filters covers what does and does not carry across.
7. Re-indexing is still running. Shopify applies this to a filter that exists but does not show all expected products or filter options: after new metafield values or other filter-related product updates, wait 24 to 48 hours for automatic re-indexing to complete before treating it as a fault.

What Happens to Filtered Links When You Rename a Filter

Filter selections appear in the address bar as query parameters, and that changed recently. Shopify announced that storefront filter URLs use stable group identifiers instead of text values from March 16, 2026, because stable identifiers make links with filters more reliable across languages and when filter labels are renamed — and all former filter URLs continue to work as expected. What those parameter URLs mean for crawling is a separate question, covered in our technical SEO audit.

How to Change What Search Returns

Knowing the indexed fields explains most “why can't they find it” complaints: if the word a shopper types is not in one of those eight fields, no setting in the app will surface the product. Shopify also publishes the exact tolerance for misspellings, which is narrower than most merchants assume.

How Do Product Boosts Work?

Boosts are the merchandising half of search: you select the products you want to promote in search results and name the terms they should win. Two boundaries decide whether a boost fires at all — and the first one is the single most common misunderstanding about the feature.

The second is availability: a product's position is only boosted while it is available for sale. Sold-out products are listed at the end of search results by default, and the Out-of-stock products setting can display or hide them instead. Boosts are also not applied when a query contains search syntax. On size, a maximum of 10 search terms can be added to one product boost, and one boost can promote several products at once.

Which Result Types Search and Predictive Search Return

The two surfaces have different menus. Predictive search displays suggested results as a shopper types, without redirecting them to a results page, and it has to be a feature of your published theme to appear at all. Whatever types you request there, by default a maximum of 10 results display across all of them combined — a limit the Predictive Search API can change.

• Search results page: product, page and blog post results — all requested by default.
• Predictive search: product, page, blog post, collection and query results, with query, product, collection and page requested by default.
• The override: these settings apply only when your theme does not specify the type query parameter — if it does, the theme wins.

One default surprises merchants with combined listings: only child products are displayed, which our FAQ on combined listing child products works through in full.

How to Keep a Product Out of Search

Shopify documents two routes that keep the product page reachable while removing it from storefront search, and for a product that should be discoverable only by direct URL it points merchants at the first. Setting a product to Unlisted also stops it displaying in Shopify-powered collection pages, in search results including predictive search, and in product recommendations. Separately, a seo.hidden metafield set to 1 hides a page, blog post or product from sitemaps, search engines and your online store search.

What About Synonyms?

Two official surfaces disagree here, so this page prints the disagreement rather than resolving it. The App Store listing, read on September 18, 2026, still advertises “Make synonym groups, so product descriptions match the terms shoppers use” among the app's five features; the app's current help page on modifying search, read the same day, does not describe the feature, its form or its limits.

Until that is settled, plan relevance on what the documentation does describe — boosts, result types and searchability — and do not promise anyone a synonym rule on the strength of the listing alone.

Related vs Complementary: What You Actually Control

The distinction is not cosmetic: complementary products are products often bought in addition to a selected product, while related products are products similar to a selected one. That is substitution against attachment, and only one of the two is automated. The limit on editing what Shopify generates is stated plainly.

Shopify Help Center, product recommendations with Search & Discovery, read September 18, 2026.

Where the generated set comes from is worth knowing before you judge it: Shopify builds related products from purchase history where the product has previous sales, from product descriptions on English storefronts only, and from related collections when neither of the first two is available. Which offers are worth showing at all, and whether a paid recommender beats the free one, is a merchandising decision our cross-sell guide takes apart.

Why the Product You Picked Isn't Showing

Shopify lists what a recommended product has to satisfy:

• It is not sold out.
• It does not have Unlisted product status.
• It has a price higher than $0.00.
• It is not a gift card.
• It is published to your Online Store sales channel.
• It is not currently in the visitor's cart.

The stock rule is stricter for complementary pairs than most merchants expect, and it is the reason a hand-picked pairing vanishes at exactly the wrong moment. You can select up to 10 complementary and up to 10 related products per product, and whether the zero-stock ones survive depends on the setting our FAQ on selling when out of stock explains.

Which Reports You Get, and What to Do With Them

Shopify Help Center, Search & Discovery analytics, read September 18, 2026. The highlighted row is the one worth reading first.

Two boundaries shape how much weight to put on these numbers. Shopify states that all of the metrics displayed include the last 30 days of data, with anything wider reached through Analytics and Reports instead; and the search reports show activity on the search results page of your online store, so customer interaction with predictive search is not included in them.

A store whose shoppers mostly use the dropdown will see less here than it expects. Viewing any of it requires the Reports staff permission.

Will the Free App Cover Your Catalog?

The table at the top answers by job — which tool fixes which symptom. This answers by combination: catalog size, where your data lives, what your theme supports, your plan and what you need beyond the three tools cross in ways a single row cannot show.

When the Free App Stops Being Enough

The case for paying is not that the free app is weak; it is that a specific capability is absent from what Shopify documents. Three come up repeatedly:

• No official page we read on September 18, 2026 describes Search & Discovery personalising recommendations for an individual signed-in shopper.
• None of those pages describes an A/B or experiment mode inside the app.
• The recommendations page makes no mention of Shopify Magic drafting complementary pairs, so every complementary pairing stays a manual decision.

One naming trap is worth clearing before you shop. The word “boost” belongs to a feature inside Shopify's own free app, and also to a separate third-party product called Boost AI Search & Filter, built by Boost Commerce. They are different things from different companies, and a search for one returns the other.

Set It Up in This Order

The order matters more than the individual settings. Steps one and two are preparation you cannot skip; step three is the one that splits across two screens, and step five reads the reports.

The Bottom Line

Most of what goes wrong with this app is not the app. A filter built on an attribute nobody stored, a theme that never had storefront filtering, a collection that grew past a documented cutoff — each of those looks like a broken app and is fixed somewhere else entirely.

Frequently Asked Questions