FAQ
Does XSearch change my theme? No. On Stencil, XSearch adds one Script Manager entry per storefront you switch on, and removes it when you switch the storefront off or uninstall the app. Catalyst storefronts integrate at the data layer. XSearch does not edit theme files, and your storefront URLs stay as they are.
What happens if XSearch is unavailable?
On Stencil, XSearch prepares its results before hiding the native listing. If a
search request fails or takes too long, the widget stands down and the
BigCommerce theme continues to render. Add ?xsearch=off to a storefront URL
to disable the widget for that page while troubleshooting.
How fresh is the index? Product changes arrive by BigCommerce webhook, usually within about five minutes. BigCommerce doesn't send webhooks for some changes, such as image-only edits and variant option renames, and occasionally drops an update. Turn on Nightly auto-sync under Settings → Indexing to re-index everything once a night; it is off by default. You can run a full re-index at any time.
Do my admin settings really match the live storefront? Yes. Storefront Preview and your storefront call the same API with the same rules. Divergence between the two is treated as a bug.
What happens to search while reindexing? A reindex builds a fresh copy of the index in the background and switches over when it completes, so shoppers keep seeing the existing results meanwhile. The exception is a store's very first index, which fills in as it builds.
Can I use my own Elasticsearch or OpenSearch cluster? Yes, on Pro and Enterprise plans. Other plans use managed infrastructure included in the plan.
What happens when I uninstall? XSearch deletes the store's search index immediately. On paid plans your configuration (filters, schema settings, promotions) is kept so a reinstall picks up where you left off; credentials and storefront switches are removed. On the free plan, everything is deleted.
What data does XSearch store? Catalog data and merchant configuration, to operate search. It also records search terms, result counts, response times and clicks on results for Search Insights. Those events are not tied to shopper accounts, cookies, email addresses or IP addresses. See the Privacy Policy for retention and deletion details.