Skip to main content

Smart Search | FAQs

Frequently Asked Questions about Smart Search

Written by Christian Sokolowski

What is Rebuy Smart Search?

Rebuy's Smart Search empowers Shopify merchants to enhance their Average Order Value (AOV) and revenue through seamless product discovery. With rapid, precise, and personalized search capabilities, our feature integrates robust data analytics for comprehensive insights. It's easy to set up and customize in minutes, eliminating the need for developer assistance.

Shopify merchants often struggle with building their own search UI or relying solely on vendors for updates, a costly and time-consuming process that limits control. Rebuy's solution harnesses AI for a self-configurable search system with modern UI and extensive customization.

Note: Smart Search has two customer-facing surfaces. Quick View is the inline search experience that opens as shoppers type — it shows product cards, suggested search terms, and collections. The Results Page is the full-page search experience that includes filters, sorting, and pagination. These surfaces are configured separately and do not share all features.


FAQs

Smart Search Compatibility

Is Smart Search compatible with stores using version 1 of Shopify?

Yes, Smart Search is compatible with Shopify-developed themes.

Will Smart Search work with Shopify markets?

Smart Search is compatible with English-only content and the stores default currency. For multi currency support, please see here.

Could Smart Search work in a Hydrogen Remix React headless setup?

Yes, Smart Search can work in a Hydrogen Remix React headless setup. We will provide API documentation that allows merchants or partners to build out their frontend for Smart Search integration.


Current Capabilities

Does Smart Search support filtering?

Smart Search supports faceted filtering on the Results Page. The Quick View does not include filter option settings.

On the Results Page, you can configure which filters shoppers see. Available filter types include availability, price, vendor, product types, product tags, product options (such as color, size, and scent), product metafields (up to 25), and variant metafields (up to 25). Filter display order is adjustable via drag-and-drop in the Results Page editor.

The Results Page filter panel layout can be set to Dropdown, Sidebar, or Flyout Filters. These settings are configured under Smart Search > Results Page Editor > General Settings > Filters.

Will Smart Search work with different languages added to a Shopify 2.0 theme?

Smart Search is compatible with English-only content.

Is Smart Search capable of showing results besides products and collections? (e.g., blog, FAQs, pages)

Smart Search now supports content search, which surfaces blog posts and pages alongside product results. Content Search must be enabled separately for Quick View and the Results Page — both are disabled by default. In Quick View, a Matching Content section appears as shoppers type, displaying relevant blog and page titles as inline links. On the Results Page, a Blog & Pages tab appears alongside the Products tab, letting shoppers switch between the two. If Content Search is not enabled, only products and collections are returned.

Will there be a way to suppress search results for out-of-stock items of a specific size that is specific to the behavior of each person’s browsing/shopping behavior?

Smart Search can hide out-of-stock variant options at the variant level using the Hide Out of Stock Variants setting. When enabled, variant options that are unavailable or out of stock are removed from the variant selector, so shoppers only see purchasable options. This setting is available in both the Quick View editor and the Results Page editor, under Variant Display. It applies store-wide and does not adapt to an individual shopper's browsing or purchase behavior. Filtering whole products by availability, based on Shopify's definition of out of stock, is handled separately by the Hide Out of Stock Products setting.

Will Rebuy’s A/B Testing feature also extend to Smart Search? (different layouts, featured products, etc)

No, this is not currently an available feature.

Will Rebuy Smart Search incorporate voice search?

No, this is not currently an available feature.

Are there Marketing or "in grid" banners available for the search results page?

No, this is not currently an available feature.

Can customers search for products using SKU's?

Yes, both Quickview & Results page support the following SKU searches.

  • Exactly match SKU.

    • SKU is AJ911581-SET and you type exactly that.

  • Partially match SKU via numeric.

    • SKU is AJ911581-SET and you type 911581.

      • Limitation: Partial SKU match is numeric only. Cannot partially match SKU BLUE2025 by typing BLUE or blue.

  • Case insensitive SKU. Can type either aj911581 or AJ911581

Does Smart Search work for subscription products?

Subscription products can be returned via Smart Search, however they cannot be added using the Smart Search ATC button. Only the one time purchase option can be added.

Does Smart Search support pre-order products?

Smart Search does not support pre-orders. Pre-order products are returned in Quick View and on the Results Page like any other product, but the Add to Cart button does not change to read "Pre-Order," and no release date or estimated ship date appears on the product card. A shopper can add a pre-order item to the cart directly from search results with no indication that it will not ship right away.

The Add to Cart button label in Smart Search comes from a single text field that applies to every product on that surface. The label changes only while an item is being added, after it has been added, or when the variant is sold out. Smart Search does not read Shopify pre-order purchase options, selling plans, or product tags to change the button.

Third-party pre-order apps are not integrated with Smart Search. If a pre-order app swaps in its own button and adds cart messaging on your product pages, that button and messaging do not carry into Smart Search product cards.

Here are your options:

  1. Send shoppers to the product page instead of adding from search. Turn off the Add to Cart button so shoppers open the product detail page, where your pre-order app's button and shipping messaging render normally. Go to Smart Search > Quick View Editor > Product Display > Call To Action and uncheck Show Add to Cart Button. Repeat this in Smart Search > Results Page Editor > Product Display > Call To Action, because Quick View and the Results Page are configured separately.

  2. Rename the button if your entire catalog is pre-order. Select EDIT next to Call To Action, then change Add to Cart Button Text to "Pre-Order." This text applies to every product on that surface, so only use it when all searchable products are pre-order items.

  3. Remove pre-order products from search results entirely. Go to Smart Search > Global Settings > Excluded Products and add either the product tags used for your pre-order items, under Product Tags, or the individual items under Specific Products. You can exclude up to 30 product tags. Excluded products do not appear in Quick View or on the Results Page, because exclusions are global and apply to both surfaces together. Only use this if you do not want shoppers finding pre-order products through search at all, and remove the exclusion once the product becomes generally available.

Can I set the default number of products per page to more than 15 without offering a dropdown?

Yes, you can set a fixed number for products per page within the Default Paging setting. This option is customizable, allowing any number between 1 and 100.

Is it possible to combine Continuous Scroll with other settings?

Continuous Scroll can be used alone or in combination with the Load More button. However, it cannot be used with the Default Paging options.

Can I change the pagination style based on the device (e.g., mobile vs. desktop)?

Currently, pagination settings are uniform across devices, but optimizing for mobile view with options like Continuous Scroll is generally recommended.

Is there a limit on how many keywords can be added to a keyword group?

Yes, there is a limit of 30 keywords per keyword group.

How do I keep a specific product from showing up in Quick View, while still letting it appear if a customer searches for it directly?

There isn't a way to exclude a product from Quick View only. The closest workaround is a global Merchandising Rule set to Demote, which ranks the product below other results while keeping it searchable. If a customer searches for it directly, it still appears, just lower when there are other matches. Hide and Exclude don't fit this goal because they pull the product out of search entirely, including direct searches.

A Demote rule only affects ranking within actual search matches, not what appears before a customer starts typing. If the product still shows near the top of Quick View before any text is entered, check the Before User Starts Typing settings in the Quick View editor. That section pulls from its own source, such as Trending Products, and any configuration set in Keywords, Quick View, or Results Page overrides global Merchandising Rules. Trending products are generated automatically, so a single product can't be removed from that list on its own, and removing it would require a global Exclude or Hide that also takes it out of search results.


Quick View vs. Results Page

What is the difference between Quick View and the Results Page?

Quick View is the inline search panel that appears as shoppers type in your store's search bar. It displays product cards, suggested search terms, and collections in real time. Quick View does not include a filter panel or sort controls.

Results Page is the full-page search experience shoppers reach when they submit a search query. It includes faceted filters, sorting options, pagination, and — if enabled — Content Search for blog posts and pages.

The two surfaces are configured independently in the Rebuy admin. Settings and features enabled in one do not automatically apply to the other.


Integrations

Can the top searches from Smart Search be synced back into Klaviyo with customer profiles for segment creation?

Not at this time.

Will we have the ability to continue using our current filtering (Search & Discovery app) in combination with Rebuy search features?

No, this is not possible.

What review apps does Smart Search work with?

Currently, Smart Search works with the following review apps:


Smart Search: Troubleshooting Missing or Misordered Results

Why aren't my products showing in Smart Search results?

If your products aren't showing in Smart Search results, this usually happens when product data hasn't finished syncing between Shopify and Rebuy. To fix it, resync your product data and, if needed, clear the relevant caches:

  1. In your Rebuy admin, go to Settings > Status and find the Data Sync Status section. Click Resync on the Products card.

  2. If products still aren't showing after the resync, clear the cache. Go to Smart Search Global Settings > Sync Manager (the gear icon), then click Run on the Product Sync card.

  3. You can also clear specific caches from Data Sources > Cache Manager. We recommend clearing the Product Cache, Product Engine Cache, and the Collections / Metafields / Presentment Prices caches.

  4. After clearing the caches, allow a few minutes for the sync to complete, then run your search again to confirm your products now appear.

If the right products still don't appear after resyncing and clearing the cache, check your exclusion and merchandising settings next.

I resynced and cleared the cache, but the right products still aren't showing. Why?

If you have resynced and cleared the cache but the right products still aren't showing — even though they are active and in stock — the next thing to check is your exclusion and merchandising settings in Smart Search Global Settings. Any of these settings can keep a product out of your results, regardless of the product's status or its keyword group. Review the settings in the following table:

Smart Search Setting

What it controls

Excluded Products

Directly excludes specific products from Smart Search. A product listed here will not appear in results.

Excluded Collections

Excludes collections from Search. With the Hide Products option enabled, every product in that collection is also hidden from results.

Merchandising Rules

Global rules that automatically boost, demote, or hide products across all search terms. A rule set to hide or demote a product can keep it out of, or low in, your results.

Excluded Terms

Excludes specific search terms. If a shopper searches an excluded term, Search returns no results for that term.

Excluded Content

Prevents specific blog posts and pages from appearing in content results on the Results Page and Quick View. This affects content, not products.

Start with Excluded Products and Excluded Collections, since those hide products directly, then review your Merchandising Rules for any rule that hides or demotes the products you expect to see.

What does the Hide Products option do in Excluded Collections?

The Hide Products option in the Excluded Collections setting controls whether the products inside an excluded collection are hidden from Smart Search, or only the collection itself is excluded. There are two outcomes:

  • Hide Products enabled: every product within that collection is hidden from Smart Search results, in addition to the collection.

  • Hide Products disabled: only the collection is kept out of Search; the products inside it can still appear in results.

If your goal is only to keep a collection from surfacing in Search while still allowing its products to be found, turn Hide Products off. Leaving it on actively hides all of that collection's products from shoppers, regardless of each product's status or keyword group.

I removed a collection from Excluded Collections but the products still aren't showing. Why?

After you remove collections from Excluded Collections or turn off Hide Products, the products may not reappear immediately, because Smart Search applies the change through a back-end sync. When a store has excluded a large number of collections and products, that sync takes longer to process and re-index the affected products. If your products do not appear right after you update the setting, allow time for the back-end sync to finish, then reload your storefront and run the search again to confirm the products now return.

Why are out-of-stock products still showing at the top of my results instead of being pushed down?

If out-of-stock products appear at the top of your results instead of being pushed lower, the cause is usually that those products are set as Featured (pinned) products. Featured and pinned products take precedence over merchandising rules and are currently exempt from them. That means an out-of-stock merchandising rule — which normally pushes out-of-stock products lower — applies only to non-featured products. A product that is both featured and out of stock will still appear in its pinned position. To have an out-of-stock product follow the push-down rule, remove it from your featured/pinned products.

Do featured or pinned products follow merchandising rules?

Featured and pinned products do not currently follow merchandising rules. Because you have manually pinned these products, they take priority and are exempt from merchandising rules such as the out-of-stock push-down. Merchandising rules apply to the rest of your non-featured results. If you need a specific product to obey a merchandising rule, do not pin it as a featured product.

What is the difference between global settings and keyword settings in Smart Search?

Smart Search uses two separate sets of settings that work together: global settings and keyword settings. Global settings are the baseline rules that apply across all of Search. Keyword settings layer on top of that baseline and are more specific, letting you control results for particular search terms. Configuring a keyword group builds on your global rules rather than replacing them, so a product can still be affected by global settings — such as Excluded Products, Excluded Collections, or Merchandising Rules — even when it belongs to a keyword group.


Advanced

Does Smart Search use Shopify Metafields as part of the search results?

Smart Search reads Shopify product metafields and variant metafields and makes them available as filter types on the Results Page. You can expose up to 25 product metafields and up to 25 variant metafields as shopper-facing filters, configured in the Results Page editor.

Does Smart Search have a custom CSS or custom code portion like Smart Cart and widgets do for further customization, especially stylistically?

Yes, you can customize Smart Search using certain APIs provided in our developer docs. Additionally, you have the option to incorporate custom CSS into the Rebuy theme to make some adjustments according to your preferences. Please note that these customizations may be limited at this time.

Will the featured badge be on every product or collection that is chosen to be featured? Will it be customizable?

By default, Featured Badges are enabled, but you can turn them off within the Smart Search settings.

How do you handle error states? Customers inevitably end up searching for help FAQs or other things outside of products.

If there are no results, nothing is returned, and we provide analytics on these searches so you can make the appropriate adjustments. If there are common search terms that yield no results, Keywords can be configured to display desired products.

How do you address typos in search queries?

We continuously improve our search functionality over time. Currently, our search engine integrates fuzzy matching, which automatically handles typos by matching search terms up to 3 characters. Additionally, we are implementing semantic search capability in the near future. If there's a common typo that isn't identified through fuzzy matching, users have the option to create a keyword group to address it.

How is customer history pulled? Do they need to log in?

Customer history is primarily pulled from cookie tracking. If customers are not signed into their accounts, 100% of the data is anonymous. This means that browsing history and interactions with the website are tracked through cookies, providing insights into customer behavior and preferences without requiring them to log in.

What if I want to show out-of-stock products but still disable the Availability filter?

Currently, the Availability filter is automatically removed only when the “Hide Out of Stock Products” option is selected. To customize filters further, you may need to look at alternative filtering options in the Smart Search Results settings.

Can I customize which products are shown when I hide out-of-stock items?

When the “Hide Out of Stock Products” option is selected, only products that are in stock will appear in search results. No additional customization for this setting is available.

Will the Availability filter automatically reappear if I change the OOS setting?

Yes, deselecting the “Hide Out of Stock Products” option will allow the Availability filter to be displayed and configurable in the Smart Search Results page settings.

Are there any performance implications to hiding out-of-stock products?

This setting has no significant impact on search performance and is optimized to enhance the user experience by filtering results based on product availability.


Reporting

How does Smart Search attribution work?

When a customer interacts with Smart Search and adds an item to the cart, the revenue generated from that purchase is attributed to Smart Search. This means that any item added to the cart directly from the search results page, quick view, or from the product detail page (PDP) after using search will count towards Smart Search RGR.

How often do the Smart Search metrics update on the Smart Search dashboard?

The Smart Search dashboard metrics accumulate and process in real time.

Did this answer your question?