Catalyst Integration
XSearch powers search and browsing on BigCommerce Catalyst (Next.js) storefronts through its public search API.
What it powers
- Search results pages
- Category and brand pages (on the URLs your store already uses)
- Faceted filtering, sorting and pagination
- Variant-aware product cards, promotion cards and badges
How it connects
Your Catalyst storefront calls the XSearch public search API with your store's channel ID. The API enforces product visibility, channel assignment and your configured field rules, so the storefront receives exactly what a shopper is allowed to see.
In the XSearch app, open Settings → Storefront API, turn the endpoint on, and add your Catalyst storefront's exact origin to the allow-list. Browser requests must come from an allowed origin; server-to-server requests send no browser origin and are not checked against it.
Client code
XSearch maintains a typed search client and React provider for Catalyst. They are shared during onboarding rather than published as public packages, so contact support for the version that matches your Catalyst release.