From 630fd267587e1a8361cc7dc7eab7cd9c8ac03773 Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Tue, 13 Jan 2026 09:17:51 -0600 Subject: [PATCH 01/14] add catalyst features doc and update messaging between stencil and catalyst --- .../catalyst/getting-started/features.mdx | 39 +++++++++++++++++++ docs/storefront/choosing-a-storefront.mdx | 38 ++++++------------ 2 files changed, 51 insertions(+), 26 deletions(-) create mode 100644 docs/storefront/catalyst/getting-started/features.mdx diff --git a/docs/storefront/catalyst/getting-started/features.mdx b/docs/storefront/catalyst/getting-started/features.mdx new file mode 100644 index 000000000..75f736c68 --- /dev/null +++ b/docs/storefront/catalyst/getting-started/features.mdx @@ -0,0 +1,39 @@ +# Features + +| Feature | Supported | Notes | +|---------|-----------|-------| +| Banners | N/A | Use [Makeswift](https://www.makeswift.com) (or an alternative) instead. | +| Hosting for Catalyst by BigCommerce | 🔴 | | +| Order Messages | 🔴 | | +| Promotional Banners | 🔴 | | +| Returns / RMA | 🔴 | Recommended to use partner solutions (e.g., Happy Returns, Returnly, Loop Returns, AfterShip). | +| App Support | 🟡 | Amount of effort required will vary depending on which type of app you have, but Catalyst compatibility for apps is possible now. Many apps already work with Catalyst, any app that exposes APIs can be integrated with some degree of effort (talk to your app developer), and we're actively investing in improved app integration methodologies in the future.

Additionally, once your app is Catalyst-compatible, you can submit your app for approval and get a "Catalyst" badge in the App Marketplace, similar to your "Multi-Storefront" badge.

To learn more about updating your app and submitting for compatibility approval, read our Building Catalyst compatible apps guide. | +| Express Wallet Buttons | 🟡 | Can be custom-integrated today; GraphQL APIs will support BC wallet buttons in 2025. | +| File Upload Product Option Type | 🟡 | | +| Gift Certificates | 🟡 | | +| Gift Wrapping | 🟡 | | +| Masquerading / Login as Customer | 🟡 | | +| Order Downloads | 🟡 | Use custom digital product fulfillment pipeline. Like agencies do for Stencil today. | +| Order Tracking Links | 🟡 | Tracking numbers available. GraphQL API and Catalyst updates planned. | +| Product Videos | 🟡 | | +| Saved Payment Methods | 🟡 | | +| Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. There are plans to support in the future, but timing is TBD. | +| ADA Compliance | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | +| B2B Open Source Buyer Portal | 🟢 | Existing B2B Buyer Portal functionality is available as an integration via https://www.catalyst.dev/docs/b2b. This, paired with existing support for Customer Groups means that Catalyst's B2B capabilities are very similar to Stencil's. A big priority for the 2025 roadmap is to provide Catalyst-native B2B components and Makeswift editability for the Buyer Portal. This work begins in February.

To learn more, check out our B2B Edition documentation. | +| Cookie Consent for GDPR/CCPA | 🟢 | | +| Customer Groups | 🟢 | Support for customer group product visibility and pricing, powered by our GraphQL API. | +| Google Analytics (GA4) | 🟢 | Integrated using BODL (Big Open Data Layer standard. Extendable for other analytics providers. | +| Multi-storefront | 🟢 | Catalyst is structured as a single-domain Next.js application, so it can only serve one domain per project out of the box. However, you can deploy multiple projects to serve multiple domains (similar to one-theme-per-domain on Stencil), and you can also wire up subpaths of the domain on Catalyst to serve either multi-language or separate channels. So, Catalyst exceeds Stencil in terms of the MSF scenarios it supports. Next.js itself does support multi-domain deployments and Catalyst could be customized to do this.

To learn more, check out the Catalyst Multi-storefront Guide | +| My Account / Orders | 🟢 | Supports profiles, addresses, and order history. Tracking links not included yet; downloadable product links not supported. | +| Native Analytics | 🟢 | We support three server-side sent events which are triggered in Catalyst middleware: visitStartedEvent, pageViewedEvent, and productViewedEvent. | +| Native Newsletter Subscription | 🟢 | | +| PCI Compliance | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | +| Persistent Cart | 🟢 | Login mutation will be extended to automatically restore and merge carts just like Stencil. | +| Promotions | 🟢 | Promotional logic works in cart; some promo banners are not yet supported (separate item). | +| Scripts API | 🟢 | Although we don't think frontend script injection is the right way for most solutions to integrate into Catalyst - we think most people would be better served by writing Server Components - we have added Scripts into GraphQL Storefront API so they can be rendered in Catalyst when it does make sense, such as for analytics pixels. | +| Single Storefront Multi-currency | 🟢 | Added in #1912, only supports transactional currencies for now, not display-only currencies. | +| Single Storefront Multi-geo | 🟢 | | +| Single Storefront Multi-Lang | 🟢 | Supports: static string translation via language files, translated product catalog (either within a single channel, or across channels) via localized subpaths, uses next-intl as localization framework, localization of content pages when built with Makeswift using Makeswift's existing localization capabilities.

To learn more, check out our Catalyst Multi-Language Guide | +| Synchronized login state between storefront and checkout; global logout | 🟢 | Enabled through Customer Access Token (CAT) used in Catalyst by default. | +| Visual Editing (Page Builder equivalent) | 🟢 | As of 1.0 Makeswift is deeply integrated into Catalyst on a distributable version of Catalyst; customers have the choice of either using Makeswift or selecting a version of Catalyst with no editor built in. | +| Wishlists | 🟢 | Wishlists are now available, see the documentation here. | diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index a55639263..0f5596b10 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -1,30 +1,22 @@ # Choosing the right storefront for your business -Choosing between Stencil, Catalyst, or a custom headless implementation can be an intimidating fork in the road. This guide will walk you through how to make the right choice and what to consider as you’re building. - -BigCommerce provides developers multiple ways to build and customize ecommerce storefronts, with two storefront styles officially supported and maintained by BigCommerce: Catalyst and Stencil. Both solutions cater to different developer needs and use cases, making it crucial to understand their differences and similarities when choosing the right approach for your project. Additionally, BigCommerce is well suited to building your own custom headless storefront with the tech stack of your choice. - -Catalyst and Stencil each serve distinct purposes in the BigCommerce ecosystem. If you’re looking for modern, API-first development with maximum flexibility, Catalyst is the way to go. On the other hand, if you prefer a more traditional, theme-based approach with minimal setup, Stencil remains a solid choice. - -Understanding the strengths and limitations of your options will help you make an informed decision when building your next BigCommerce storefront. - -Let’s dive into the details\! +BigCommerce provides developers multiple ways to build and customize ecommerce storefronts catering to different developer needs and use cases. This makes it crucial to understand their differences and similarities when choosing the right approach for your project. This guide will walk you through choosing between our primary storefront options: [Stencil](/docs/storefront/stencil/start), [Catalyst](/docs/storefront/catalyst), and a custom headless implementation. ## What is Stencil? -Stencil is BigCommerce’s traditional theme engine, used for customizing storefronts within the BigCommerce platform. It’s an integrated, template-based design system that allows developers to build and modify themes using Handlebars.js templates, SCSS, and JavaScript. +Stencil is BigCommerce’s traditional storefront option, used for customizing storefronts within the BigCommerce platform. It’s an integrated, template-based design system that allows developers to build and modify themes using Handlebars.js templates, SCSS, and JavaScript. **Key Features of Stencil:** * Theme-Based Architecture – Uses predefined templates and layouts for easier customization * Fully Hosted – Runs directly on the BigCommerce platform without requiring external hosting -* Uses Handlebars.js for Templating – Simplifies frontend development with logic-less templates +* Uses Handlebars.js for Templating – Simplifies frontend development with templates * Integrated with BigCommerce's Backend – Handles checkout, cart, and product rendering without needing API calls * Optimized for Performance – Includes built-in caching and CDN delivery for fast load times ## What is Catalyst? -Catalyst is BigCommerce’s headless and composable Next.js-based reference storefront architecture, designed to provide developers with a modern, high-performance framework for building composable ecommerce experiences. Catalyst leverages Next.js, React, and BigCommerce’s GraphQL Storefront API, enabling flexibility and speed while maintaining full control over the frontend experience. Catalyst leverages Makeswift Visual Builder, which allows users to fully customize the layout and design of their storefront without needing to get developers involved. +Catalyst is BigCommerce’s headless and composable reference architecture for building modern, high-performance storefronts. Catalyst leverages Next.js, React, and BigCommerce’s GraphQL Storefront API, enabling flexibility and speed while maintaining full control over the frontend experience. Catalyst is also integrated with the [Makeswift Visual Builder](https://www.makeswift.com), which allows users to fully customize the layout and design of their storefront without needing to get developers involved. **Key Features of Catalyst:** @@ -39,23 +31,19 @@ Catalyst is BigCommerce’s headless and composable Next.js-based reference stor Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, flexible, and scalable ecommerce experience. By decoupling the frontend, you can use your preferred frameworks to create a dynamic, SEO-friendly site while BigCommerce powers commerce operations. The GraphQL Storefront API optimizes data fetching, improving performance and enabling seamless integrations. This modern, API-first approach allows for personalized experiences, custom checkout flows, and easy third-party integrations. -**Key Features of Headless Builds:** - -* Numerous apps, integrations and plugins available and provide expanded functionality -* We recommend minimizing your plugin volume and keeping in mind that the most performant integration into BC isn’t going to be a plugin, but rather a direct integration into the platform (which is available with Catalyst) -## Key Differences Between Catalyst and Stencil +## Key Differences | Feature | Stencil | Catalyst | Custom Headless | | --- | --- | --- | --- | -| Architecture | Monolithic | Headless (Next.js) | Headless (Any framework) | +| Architecture | Monolithic | Headless (Next.js) | Headless (any framework) | | Frontend Tech | Handlebars.js, SaaS, JavaScript | React, Next.js, GraphQL | Any (React, Vue, Svelte, Angular, etc.) | -| Hosting | Fully hosted by BigCommerce | External (Vercel, AWS, etc.) | External (AWS, GCP, Vercel, Netlify, etc.) | -| API Usage | Directly integrated with BigCommerce backend | Requires GraphQL Storefront API for data | Requires Storefront API (GraphQL/REST) for data | -| Customization | Limited to custom templates and client-side functionality | Fully customizable | Fully customizable, but requires more development effort | -| Performance | Optimized via BigCommerce’s CDN | Optimized via SSR/ISR | Depends on implementation and hosting | -| Development Workflow | Theme customization via CLI | Git, CI/CD, and modern tooling | Custom CI/CD setup based on tech stack | -| Integration Support | Supports BigCommerce apps and some third-party integrations | Easier to integrate with external APIs and third-party services | Fully flexible, but integrations require manual setup | +| Hosting | Fully hosted by BigCommerce | External (Vercel, AWS, etc.) | External (Vercel, AWS, etc.) | +| API Usage | Directly integrated with BigCommerce backend | Storefront API (GraphQL) | Storefront API (GraphQL/REST) | +| Customization | Limited customization | Fully customizable | Fully customizable | +| Performance | Optimized via BigCommerce’s CDN | Optimized via caching | Manual optimization | +| Development Workflow | Theme customization via CLI | Git, CI/CD, and modern tooling | Git, CI/CD, and modern tooling | +| Integration Support | Supports BigCommerce apps and some third-party integrations | Integrate with external APIs and third-party services | Integrate with external APIs and third-party services | ## Choosing between these options @@ -71,8 +59,6 @@ Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, * A modern, composable approach with React and Next.js * Complete control over the entire frontend application * A flexible API-driven architecture -* Close alignment between marketing and development teams -* A fast time-to-market for a well-architected composable storefront **Choose a custom headless build if you need:** From 5a1386d0923574ed7b88d2df5f189361a328c63f Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Wed, 14 Jan 2026 13:39:04 -0600 Subject: [PATCH 02/14] Add supported features docs and update choosing a storefront details --- .../catalyst/features/supported-features.mdx | 54 +++++++++++++++++++ .../catalyst/getting-started/features.mdx | 39 -------------- docs/storefront/choosing-a-storefront.mdx | 22 +++++--- 3 files changed, 70 insertions(+), 45 deletions(-) create mode 100644 docs/storefront/catalyst/features/supported-features.mdx delete mode 100644 docs/storefront/catalyst/getting-started/features.mdx diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx new file mode 100644 index 000000000..f166e059f --- /dev/null +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -0,0 +1,54 @@ +# Feature Support + +Here is a list of BigCommerce platform features and whether or not they are supported and to what extent in Catalyst. One important note when considering Catalyst features support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features cannot be supported in Catalyst until the functionality is available in the GraphQL Storefront API. + +This list is not intended to be a direct feature parity comparison with [Stencil](/docs/storefront/stencil). However, it does provide a good overview to be when considering Catalyst vs Stencil. + +## Feature Support Status Legend + +- 🟢 **Green**: Natively supported in Catalyst +- 🟡 **Yellow**: Partially supported but might be missing functionality +- 🔴 **Red**: Not supported + +Since you have complete ownership of the code with Catalyst, you can custom build implementations of yellow and red features if you would like to. + +| Feature | Supported | Notes | +|---------|-----------|-------| +| [Banners](https://support.bigcommerce.com/s/article/Creating-Editing-Banners) | 🔴 | Use [Makeswift](https://www.makeswift.com) (or an alternative) instead. | +| Hosting for Catalyst by BigCommerce | 🔴 | Requires hosting your own storefront code. | +| [Meta Pixel](https://support.bigcommerce.com/s/article/Meta-Pixel) | 🔴 | | +| [Draft Orders](https://support.bigcommerce.com/s/article/Creating-a-Draft-Order) | 🔴 | Specifically, the ability for Catalyst to take a customer-facing Draft Order URL and apply it to the Catalyst session is not supported. | +| [Order Messages](https://support.bigcommerce.com/s/article/Communicating-with-Customers#Messages) | 🔴 | Specfically, the ability for a customer to add additional messages on the order details page after checkout is not supported. | +| Promotional Banners | 🔴 | | +| Returns / RMA | 🔴 | Recommended to use partner solutions (e.g., Happy Returns, Returnly, Loop Returns, AfterShip). | +| File Upload Product Option Type | 🔴 | | +| [B2B Open Source Buyer Portal](https://github.com/bigcommerce/b2b-buyer-portal) | 🔴 | Although you can layer in the Open Source Buyer Portal into Catalyst, it is not natively supported. | +| [App Support](https://support.bigcommerce.com/s/article/Apps-Video) | 🟡 | Back-office apps focused on backend and Control Panel functionality are supported in Catalyst. Additionally, any app that exposes APIs can be integrated with custom code. However, storefront apps that modify frontend storefront behavior most likely will not work with Catalyst. To learn more about app compatibility with Catalyst, read our [Building Catalyst compatible apps guide](/docs/integrations/apps/guide/catalyst-compatible-apps). | +| Express Wallet Buttons | 🟡 | Can be custom-built using the GraphQL Storefront API | +| [Gift Wrapping](https://support.bigcommerce.com/s/article/Gift-Wrapping) | 🟡 | | +| Masquerading / Login as Customer | 🟡 | | +| Order Downloads | 🟡 | Use custom digital product fulfillment pipeline. Like agencies do for Stencil today. | +| Order Tracking Links | 🟡 | | +| Product Videos | 🟡 | | +| [Saved Payment Methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods) | 🟡 | | +| Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. | +| [ADA Compliance](https://support.bigcommerce.com/s/article/Accessibility-ADA-Compliance) | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | +| [Cookie Consent for GDPR/CCPA](https://support.bigcommerce.com/s/article/Security-and-Privacy-Settings) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| +| [Product Reviews](https://support.bigcommerce.com/s/article/Customer-Groups) | 🟢 | Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0) | +| [Customer Groups](https://support.bigcommerce.com/s/article/Customer-Groups) | 🟢 | Support for customer group product visibility and pricing, powered by our GraphQL API. | +| [Gift Certificates](https://support.bigcommerce.com/s/article/Gift-Certificates) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| +| [Google Analytics (GA4)](https://support.bigcommerce.com/s/article/Google-Analytics-4-Events) | 🟢 | Integrated using BODL (Big Open Data Layer standard. Extendable for other analytics providers. | +| [Multi-storefront](https://support.bigcommerce.com/s/article/Multi-Storefront) | 🟢 | Catalyst is structured as a single-domain Next.js application, so it can only serve one domain per project out of the box. However, you can deploy multiple projects to serve multiple domains (similar to one-theme-per-domain on Stencil), and you can also wire up subpaths of the domain on Catalyst to serve either multi-language or separate channels. So, Catalyst exceeds Stencil in terms of the MSF scenarios it supports. Next.js itself does support multi-domain deployments and Catalyst could be customized to do this.

To learn more, check out the Catalyst Multi-storefront Guide | +| My Account / Orders | 🟢 | Supports profiles, addresses, and order history. Tracking links not included yet; downloadable product links not supported. | +| Native Analytics | 🟢 | We support three server-side sent events which are triggered in Catalyst middleware: visitStartedEvent, pageViewedEvent, and productViewedEvent. | +| [Newsletter Subscription](https://support.bigcommerce.com/s/article/Collecting-Newsletter-Subscriptions?language=en_US) | 🟢 | Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0)| +| PCI Compliance | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | +| [Persistent Cart](https://support.bigcommerce.com/s/article/Persistent-Cart) | 🟢 | Login mutation will be extended to automatically restore and merge carts just like Stencil. | +| [Promotions](https://support.bigcommerce.com/s/article/Promotions-Video) | 🟢 | Promotional logic works in cart; some promo banners are not yet supported (separate item). | +| [Scripts API](https://support.bigcommerce.com/s/article/Using-Script-Manager) | 🟢 | Although we don't think frontend script injection is the right way for most solutions to integrate into Catalyst - we think most people would be better served by writing Server Components - we have added Scripts into GraphQL Storefront API so they can be rendered in Catalyst when it does make sense, such as for analytics pixels. | +| Single Storefront Multi-currency | 🟢 | Added in #1912, only supports transactional currencies for now, not display-only currencies. | +| Single Storefront Multi-geo | 🟢 | | +| Single Storefront Multi-Lang | 🟢 | Supports: static string translation via language files, translated product catalog (either within a single channel, or across channels) via localized subpaths, uses next-intl as localization framework, localization of content pages when built with Makeswift using Makeswift's existing localization capabilities.

To learn more, check out our Catalyst Multi-Language Guide | +| Synchronized login state between storefront and checkout; global logout | 🟢 | Enabled through Customer Access Token (CAT) used in Catalyst by default. | +| Visual Editing (Page Builder equivalent) | 🟢 | As of 1.0 Makeswift is deeply integrated into Catalyst on a distributable version of Catalyst; customers have the choice of either using Makeswift or selecting a version of Catalyst with no editor built in. | +| Wishlists | 🟢 | [Wishlist Catalyst documentation](/docs/storefront/catalyst/reference/wishlists) | diff --git a/docs/storefront/catalyst/getting-started/features.mdx b/docs/storefront/catalyst/getting-started/features.mdx deleted file mode 100644 index 75f736c68..000000000 --- a/docs/storefront/catalyst/getting-started/features.mdx +++ /dev/null @@ -1,39 +0,0 @@ -# Features - -| Feature | Supported | Notes | -|---------|-----------|-------| -| Banners | N/A | Use [Makeswift](https://www.makeswift.com) (or an alternative) instead. | -| Hosting for Catalyst by BigCommerce | 🔴 | | -| Order Messages | 🔴 | | -| Promotional Banners | 🔴 | | -| Returns / RMA | 🔴 | Recommended to use partner solutions (e.g., Happy Returns, Returnly, Loop Returns, AfterShip). | -| App Support | 🟡 | Amount of effort required will vary depending on which type of app you have, but Catalyst compatibility for apps is possible now. Many apps already work with Catalyst, any app that exposes APIs can be integrated with some degree of effort (talk to your app developer), and we're actively investing in improved app integration methodologies in the future.

Additionally, once your app is Catalyst-compatible, you can submit your app for approval and get a "Catalyst" badge in the App Marketplace, similar to your "Multi-Storefront" badge.

To learn more about updating your app and submitting for compatibility approval, read our Building Catalyst compatible apps guide. | -| Express Wallet Buttons | 🟡 | Can be custom-integrated today; GraphQL APIs will support BC wallet buttons in 2025. | -| File Upload Product Option Type | 🟡 | | -| Gift Certificates | 🟡 | | -| Gift Wrapping | 🟡 | | -| Masquerading / Login as Customer | 🟡 | | -| Order Downloads | 🟡 | Use custom digital product fulfillment pipeline. Like agencies do for Stencil today. | -| Order Tracking Links | 🟡 | Tracking numbers available. GraphQL API and Catalyst updates planned. | -| Product Videos | 🟡 | | -| Saved Payment Methods | 🟡 | | -| Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. There are plans to support in the future, but timing is TBD. | -| ADA Compliance | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | -| B2B Open Source Buyer Portal | 🟢 | Existing B2B Buyer Portal functionality is available as an integration via https://www.catalyst.dev/docs/b2b. This, paired with existing support for Customer Groups means that Catalyst's B2B capabilities are very similar to Stencil's. A big priority for the 2025 roadmap is to provide Catalyst-native B2B components and Makeswift editability for the Buyer Portal. This work begins in February.

To learn more, check out our B2B Edition documentation. | -| Cookie Consent for GDPR/CCPA | 🟢 | | -| Customer Groups | 🟢 | Support for customer group product visibility and pricing, powered by our GraphQL API. | -| Google Analytics (GA4) | 🟢 | Integrated using BODL (Big Open Data Layer standard. Extendable for other analytics providers. | -| Multi-storefront | 🟢 | Catalyst is structured as a single-domain Next.js application, so it can only serve one domain per project out of the box. However, you can deploy multiple projects to serve multiple domains (similar to one-theme-per-domain on Stencil), and you can also wire up subpaths of the domain on Catalyst to serve either multi-language or separate channels. So, Catalyst exceeds Stencil in terms of the MSF scenarios it supports. Next.js itself does support multi-domain deployments and Catalyst could be customized to do this.

To learn more, check out the Catalyst Multi-storefront Guide | -| My Account / Orders | 🟢 | Supports profiles, addresses, and order history. Tracking links not included yet; downloadable product links not supported. | -| Native Analytics | 🟢 | We support three server-side sent events which are triggered in Catalyst middleware: visitStartedEvent, pageViewedEvent, and productViewedEvent. | -| Native Newsletter Subscription | 🟢 | | -| PCI Compliance | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | -| Persistent Cart | 🟢 | Login mutation will be extended to automatically restore and merge carts just like Stencil. | -| Promotions | 🟢 | Promotional logic works in cart; some promo banners are not yet supported (separate item). | -| Scripts API | 🟢 | Although we don't think frontend script injection is the right way for most solutions to integrate into Catalyst - we think most people would be better served by writing Server Components - we have added Scripts into GraphQL Storefront API so they can be rendered in Catalyst when it does make sense, such as for analytics pixels. | -| Single Storefront Multi-currency | 🟢 | Added in #1912, only supports transactional currencies for now, not display-only currencies. | -| Single Storefront Multi-geo | 🟢 | | -| Single Storefront Multi-Lang | 🟢 | Supports: static string translation via language files, translated product catalog (either within a single channel, or across channels) via localized subpaths, uses next-intl as localization framework, localization of content pages when built with Makeswift using Makeswift's existing localization capabilities.

To learn more, check out our Catalyst Multi-Language Guide | -| Synchronized login state between storefront and checkout; global logout | 🟢 | Enabled through Customer Access Token (CAT) used in Catalyst by default. | -| Visual Editing (Page Builder equivalent) | 🟢 | As of 1.0 Makeswift is deeply integrated into Catalyst on a distributable version of Catalyst; customers have the choice of either using Makeswift or selecting a version of Catalyst with no editor built in. | -| Wishlists | 🟢 | Wishlists are now available, see the documentation here. | diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index 0f5596b10..1d8032341 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -1,6 +1,6 @@ # Choosing the right storefront for your business -BigCommerce provides developers multiple ways to build and customize ecommerce storefronts catering to different developer needs and use cases. This makes it crucial to understand their differences and similarities when choosing the right approach for your project. This guide will walk you through choosing between our primary storefront options: [Stencil](/docs/storefront/stencil/start), [Catalyst](/docs/storefront/catalyst), and a custom headless implementation. +BigCommerce provides developers multiple ways to build and customize ecommerce storefronts catering to different developer needs and use cases. This makes it crucial to understand their differences and similarities when choosing the right approach for your project. This guide will walk you through choosing between our primary storefront options, [Stencil](/docs/storefront/stencil/start) and [Catalyst](/docs/storefront/catalyst), as well as a custom headless implementation. ## What is Stencil? @@ -18,6 +18,8 @@ Stencil is BigCommerce’s traditional storefront option, used for customizing s Catalyst is BigCommerce’s headless and composable reference architecture for building modern, high-performance storefronts. Catalyst leverages Next.js, React, and BigCommerce’s GraphQL Storefront API, enabling flexibility and speed while maintaining full control over the frontend experience. Catalyst is also integrated with the [Makeswift Visual Builder](https://www.makeswift.com), which allows users to fully customize the layout and design of their storefront without needing to get developers involved. +Catalyst is built with the [BigCommerce GraphQL Storefront API](/docs/storefront/graphql) which does not support all BigCommerce platform features. For a list of features and whether or not they are supported and to what extent in Catalyst, see the [Feature Support](/docs/storefront/catalyst/features/supported-features) page. + **Key Features of Catalyst:** * **Built on Next.js** – Uses React and server-side rendering (SSR) for optimized performance @@ -26,10 +28,18 @@ Catalyst is BigCommerce’s headless and composable reference architecture for b * **Uses the GraphQL Storefront API** – Fetches product data, categories, and cart details via GraphQL * **Fully customizable** - Developers have full control over storefront design, UI/UX, client- and server-side functionality * **Supports modern development workflows** – Works seamlessly with Git-based version control, CI/CD, and composable commerce architectures +- **Requires hosting** - you are reponsible for hosting your deployed storefront code + +** Limitations of Catalyst:** + +* **GraphQL Storefront API Limitations:** - The GraphQL Storefront API that Catalyst depends on does not support all BigCommerce platform features +* **Hosting:** - You are responsible for hosting your deployed storefront code +* **App Marketplace** - Apps from the App Marketplace are not all supported +* **Themes:** - Catalyst does not provide a list of themes to choose from. However, you can customise the existing theme in code or by using Makeswift -## What does a custom headless build look like on BigCommerce? +## Headless? -Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, flexible, and scalable ecommerce experience. By decoupling the frontend, you can use your preferred frameworks to create a dynamic, SEO-friendly site while BigCommerce powers commerce operations. The GraphQL Storefront API optimizes data fetching, improving performance and enabling seamless integrations. This modern, API-first approach allows for personalized experiences, custom checkout flows, and easy third-party integrations. +While Catalyst is a headless implementation, if you'd like to build a storefront using a different tech stack, you can do that as well. Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, flexible, and scalable ecommerce experience. By decoupling the frontend, you can use your preferred frameworks to create a dynamic, SEO-friendly site while BigCommerce powers commerce operations. The GraphQL Storefront API optimizes data fetching, improving performance and enabling seamless integrations. This modern, API-first approach allows for personalized experiences, custom checkout flows, and easy third-party integrations. ## Key Differences @@ -67,7 +77,7 @@ Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, ## Additional Resources: -* [Catalyst Documentation](https://www.catalyst.dev/) -* [Stencil Documentation](https://developer.bigcommerce.com/docs/storefront/stencil/start) -* [BigCommerce API Reference](https://developer.bigcommerce.com/docs/api) +* [Catalyst Documentation](/docs/storefront/catalyst) +* [Stencil Documentation](/docs/storefront/stencil/start) +* [BigCommerce API Reference](/docs/api) From 9e275c7d79cf7dcb96afe04c47a026aee1be96a4 Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Wed, 14 Jan 2026 13:39:52 -0600 Subject: [PATCH 03/14] update wording on feature support --- docs/storefront/choosing-a-storefront.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index 1d8032341..29ffeccf1 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -18,7 +18,7 @@ Stencil is BigCommerce’s traditional storefront option, used for customizing s Catalyst is BigCommerce’s headless and composable reference architecture for building modern, high-performance storefronts. Catalyst leverages Next.js, React, and BigCommerce’s GraphQL Storefront API, enabling flexibility and speed while maintaining full control over the frontend experience. Catalyst is also integrated with the [Makeswift Visual Builder](https://www.makeswift.com), which allows users to fully customize the layout and design of their storefront without needing to get developers involved. -Catalyst is built with the [BigCommerce GraphQL Storefront API](/docs/storefront/graphql) which does not support all BigCommerce platform features. For a list of features and whether or not they are supported and to what extent in Catalyst, see the [Feature Support](/docs/storefront/catalyst/features/supported-features) page. +Catalyst is built with the [BigCommerce GraphQL Storefront API](/docs/storefront/graphql) which does not support all BigCommerce platform features. For a list of features and whether or not they are supported and to what extent in Catalyst, see the [Supported Features](/docs/storefront/catalyst/features/supported-features) page. **Key Features of Catalyst:** From f226222bbfb586f66acb2b49e4035ea20ddd191d Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Wed, 14 Jan 2026 13:43:42 -0600 Subject: [PATCH 04/14] remove question mark from header --- docs/storefront/choosing-a-storefront.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index 29ffeccf1..12165ecee 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -37,7 +37,7 @@ Catalyst is BigCommerce’s headless and composable reference architecture for b * **App Marketplace** - Apps from the App Marketplace are not all supported * **Themes:** - Catalyst does not provide a list of themes to choose from. However, you can customise the existing theme in code or by using Makeswift -## Headless? +## Headless While Catalyst is a headless implementation, if you'd like to build a storefront using a different tech stack, you can do that as well. Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, flexible, and scalable ecommerce experience. By decoupling the frontend, you can use your preferred frameworks to create a dynamic, SEO-friendly site while BigCommerce powers commerce operations. The GraphQL Storefront API optimizes data fetching, improving performance and enabling seamless integrations. This modern, API-first approach allows for personalized experiences, custom checkout flows, and easy third-party integrations. From 4d8bb3604eccf557513bd9fc6acd373820172e71 Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Wed, 14 Jan 2026 14:59:26 -0600 Subject: [PATCH 05/14] add line item for sitemaps --- docs/storefront/catalyst/features/supported-features.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index f166e059f..0acfa1aa1 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -31,6 +31,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | Order Tracking Links | 🟡 | | | Product Videos | 🟡 | | | [Saved Payment Methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods) | 🟡 | | +| Sitemap | 🟡 | Catalyst does generate a sitemap for you, but it does not factor in routes that are not managed by BigCommerce. For example, it does not include routes that are created in Makeswift | | Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. | | [ADA Compliance](https://support.bigcommerce.com/s/article/Accessibility-ADA-Compliance) | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | | [Cookie Consent for GDPR/CCPA](https://support.bigcommerce.com/s/article/Security-and-Privacy-Settings) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| From f79291a2f6336d7fba49fc006900df53274d282c Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Wed, 14 Jan 2026 15:21:46 -0600 Subject: [PATCH 06/14] add line item for in app search --- docs/storefront/catalyst/features/supported-features.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 0acfa1aa1..d8e48d908 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -32,6 +32,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | Product Videos | 🟡 | | | [Saved Payment Methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods) | 🟡 | | | Sitemap | 🟡 | Catalyst does generate a sitemap for you, but it does not factor in routes that are not managed by BigCommerce. For example, it does not include routes that are created in Makeswift | +| In-app search | 🟡 | Catalyst does support search for BigCommerce products, but it does not factor in content that is not managed by BigCommerce. For example, it does not include content that is created in Makeswift | | Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. | | [ADA Compliance](https://support.bigcommerce.com/s/article/Accessibility-ADA-Compliance) | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | | [Cookie Consent for GDPR/CCPA](https://support.bigcommerce.com/s/article/Security-and-Privacy-Settings) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| From e08fbe4e2e4b67d774582c2c5bd30618f1ce9177 Mon Sep 17 00:00:00 2001 From: James Q Quick Date: Thu, 15 Jan 2026 13:23:23 -0500 Subject: [PATCH 07/14] Update docs/storefront/catalyst/features/supported-features.mdx Co-authored-by: Miguel Oller --- docs/storefront/catalyst/features/supported-features.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index d8e48d908..cc8b103e2 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -1,6 +1,6 @@ # Feature Support -Here is a list of BigCommerce platform features and whether or not they are supported and to what extent in Catalyst. One important note when considering Catalyst features support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features cannot be supported in Catalyst until the functionality is available in the GraphQL Storefront API. +Here is a list of BigCommerce platform features and whether or not they are supported and to what extent in Catalyst. One important note when considering Catalyst feature support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features cannot be supported in Catalyst until the functionality is available in the GraphQL Storefront API. This list is not intended to be a direct feature parity comparison with [Stencil](/docs/storefront/stencil). However, it does provide a good overview to be when considering Catalyst vs Stencil. From c4a9bb1a04af5cdb0dbf47b80ce161f7560764ec Mon Sep 17 00:00:00 2001 From: James Q Quick Date: Thu, 15 Jan 2026 13:23:45 -0500 Subject: [PATCH 08/14] Update docs/storefront/catalyst/features/supported-features.mdx Co-authored-by: Miguel Oller --- docs/storefront/catalyst/features/supported-features.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index cc8b103e2..544c373cf 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -2,7 +2,7 @@ Here is a list of BigCommerce platform features and whether or not they are supported and to what extent in Catalyst. One important note when considering Catalyst feature support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features cannot be supported in Catalyst until the functionality is available in the GraphQL Storefront API. -This list is not intended to be a direct feature parity comparison with [Stencil](/docs/storefront/stencil). However, it does provide a good overview to be when considering Catalyst vs Stencil. +This list is not intended to be a direct feature parity comparison with [Stencil](/docs/storefront/stencil). However, it does provide a good overview when considering Catalyst vs Stencil. ## Feature Support Status Legend From f8712eaff4a35630419a13cd5b3ca4b314a6c201 Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 12:26:53 -0600 Subject: [PATCH 09/14] add additional details for deplyoying catalyst --- docs/storefront/catalyst/features/supported-features.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 544c373cf..78f17b960 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -15,7 +15,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | Feature | Supported | Notes | |---------|-----------|-------| | [Banners](https://support.bigcommerce.com/s/article/Creating-Editing-Banners) | 🔴 | Use [Makeswift](https://www.makeswift.com) (or an alternative) instead. | -| Hosting for Catalyst by BigCommerce | 🔴 | Requires hosting your own storefront code. | +| Hosting for Catalyst by BigCommerce | 🔴 | Requires hosting your own storefront code (ex. Vercel, AWS, Cloudflare, etc.). See the [Deploying a Catalyst storefront guide](/docs/storefront/catalyst/getting-started/deploying/overview) for more information. | | [Meta Pixel](https://support.bigcommerce.com/s/article/Meta-Pixel) | 🔴 | | | [Draft Orders](https://support.bigcommerce.com/s/article/Creating-a-Draft-Order) | 🔴 | Specifically, the ability for Catalyst to take a customer-facing Draft Order URL and apply it to the Catalyst session is not supported. | | [Order Messages](https://support.bigcommerce.com/s/article/Communicating-with-Customers#Messages) | 🔴 | Specfically, the ability for a customer to add additional messages on the order details page after checkout is not supported. | From 0325176a89f88a832ae6812ba2eba0b97621837f Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 12:31:14 -0600 Subject: [PATCH 10/14] add line item for abandoned cart --- docs/storefront/catalyst/features/supported-features.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 78f17b960..7ffdf5886 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -21,6 +21,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | [Order Messages](https://support.bigcommerce.com/s/article/Communicating-with-Customers#Messages) | 🔴 | Specfically, the ability for a customer to add additional messages on the order details page after checkout is not supported. | | Promotional Banners | 🔴 | | | Returns / RMA | 🔴 | Recommended to use partner solutions (e.g., Happy Returns, Returnly, Loop Returns, AfterShip). | +| [Abandoned Cart](https://support.bigcommerce.com/s/article/Using-the-Abandoned-Cart-Saver?language=en_US) | 🔴 | Specifically, the ability for Catalyst to take a customer-facing Abandoned Cart URL and apply it to the Catalyst cart is not supported. | | File Upload Product Option Type | 🔴 | | | [B2B Open Source Buyer Portal](https://github.com/bigcommerce/b2b-buyer-portal) | 🔴 | Although you can layer in the Open Source Buyer Portal into Catalyst, it is not natively supported. | | [App Support](https://support.bigcommerce.com/s/article/Apps-Video) | 🟡 | Back-office apps focused on backend and Control Panel functionality are supported in Catalyst. Additionally, any app that exposes APIs can be integrated with custom code. However, storefront apps that modify frontend storefront behavior most likely will not work with Catalyst. To learn more about app compatibility with Catalyst, read our [Building Catalyst compatible apps guide](/docs/integrations/apps/guide/catalyst-compatible-apps). | From 5fc28881c8aab2106efef6697902ed366b3a2fad Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 12:37:01 -0600 Subject: [PATCH 11/14] added link to session sync documentation --- docs/storefront/catalyst/features/supported-features.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 7ffdf5886..0bcb4508d 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -34,7 +34,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | [Saved Payment Methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods) | 🟡 | | | Sitemap | 🟡 | Catalyst does generate a sitemap for you, but it does not factor in routes that are not managed by BigCommerce. For example, it does not include routes that are created in Makeswift | | In-app search | 🟡 | Catalyst does support search for BigCommerce products, but it does not factor in content that is not managed by BigCommerce. For example, it does not include content that is created in Makeswift | -| Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. | +| Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. For more details, refer to the [Session Sync documentation](/docs/storefront/catalyst/development/session-sync). | | [ADA Compliance](https://support.bigcommerce.com/s/article/Accessibility-ADA-Compliance) | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | | [Cookie Consent for GDPR/CCPA](https://support.bigcommerce.com/s/article/Security-and-Privacy-Settings) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| | [Product Reviews](https://support.bigcommerce.com/s/article/Customer-Groups) | 🟢 | Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0) | From 2fe96d7309d7e4df9fc1632225aa6f506424f42a Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 16:25:28 -0600 Subject: [PATCH 12/14] updated language and ordering of supported features --- .../catalyst/features/supported-features.mdx | 13 +++++++------ docs/storefront/choosing-a-storefront.mdx | 4 ++-- 2 files changed, 9 insertions(+), 8 deletions(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 0bcb4508d..44785b88c 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -1,6 +1,6 @@ # Feature Support -Here is a list of BigCommerce platform features and whether or not they are supported and to what extent in Catalyst. One important note when considering Catalyst feature support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features cannot be supported in Catalyst until the functionality is available in the GraphQL Storefront API. +Below is a list of major BigCommerce platform features, detailing what support exists in Catalyst. One important note when considering Catalyst feature support is that Catalyst is focused on working with the [GraphQL Storefront API](/docs/storefront/graphql) and not the [REST Management API](/docs/rest-management). This means that some features will not be supported out of the box in Catalyst until the functionality is available in the GraphQL Storefront API. However, you can still build custom implementations when necessary by leveraging the REST Management API. This list is not intended to be a direct feature parity comparison with [Stencil](/docs/storefront/stencil). However, it does provide a good overview when considering Catalyst vs Stencil. @@ -15,7 +15,7 @@ Here is a list of BigCommerce platform features and whether or not they are supp | Feature | Supported | Notes | |---------|-----------|-------| | [Banners](https://support.bigcommerce.com/s/article/Creating-Editing-Banners) | 🔴 | Use [Makeswift](https://www.makeswift.com) (or an alternative) instead. | -| Hosting for Catalyst by BigCommerce | 🔴 | Requires hosting your own storefront code (ex. Vercel, AWS, Cloudflare, etc.). See the [Deploying a Catalyst storefront guide](/docs/storefront/catalyst/getting-started/deploying/overview) for more information. | +| Hosting by BigCommerce | 🔴 | Requires hosting on your own provider (ex. Vercel, AWS, Cloudflare, etc.). See the [Deploying a Catalyst storefront guide](/docs/storefront/catalyst/getting-started/deploying/overview) for more information. | | [Meta Pixel](https://support.bigcommerce.com/s/article/Meta-Pixel) | 🔴 | | | [Draft Orders](https://support.bigcommerce.com/s/article/Creating-a-Draft-Order) | 🔴 | Specifically, the ability for Catalyst to take a customer-facing Draft Order URL and apply it to the Catalyst session is not supported. | | [Order Messages](https://support.bigcommerce.com/s/article/Communicating-with-Customers#Messages) | 🔴 | Specfically, the ability for a customer to add additional messages on the order details page after checkout is not supported. | @@ -23,18 +23,19 @@ Here is a list of BigCommerce platform features and whether or not they are supp | Returns / RMA | 🔴 | Recommended to use partner solutions (e.g., Happy Returns, Returnly, Loop Returns, AfterShip). | | [Abandoned Cart](https://support.bigcommerce.com/s/article/Using-the-Abandoned-Cart-Saver?language=en_US) | 🔴 | Specifically, the ability for Catalyst to take a customer-facing Abandoned Cart URL and apply it to the Catalyst cart is not supported. | | File Upload Product Option Type | 🔴 | | -| [B2B Open Source Buyer Portal](https://github.com/bigcommerce/b2b-buyer-portal) | 🔴 | Although you can layer in the Open Source Buyer Portal into Catalyst, it is not natively supported. | +| Product Videos | 🔴 | Can be custom-built using the GraphQL Storefront API | +| Express Wallet Buttons | 🔴 | Can be custom-built using the GraphQL Storefront API | +| [B2B Open Source Buyer Portal](https://github.com/bigcommerce/b2b-buyer-portal) | 🟡 | There is an **experimental** integration available. See the [Catalyst + B2B Buyer Portal](/docs/storefront/catalyst/experiments/b2b) guide for more information. | | [App Support](https://support.bigcommerce.com/s/article/Apps-Video) | 🟡 | Back-office apps focused on backend and Control Panel functionality are supported in Catalyst. Additionally, any app that exposes APIs can be integrated with custom code. However, storefront apps that modify frontend storefront behavior most likely will not work with Catalyst. To learn more about app compatibility with Catalyst, read our [Building Catalyst compatible apps guide](/docs/integrations/apps/guide/catalyst-compatible-apps). | -| Express Wallet Buttons | 🟡 | Can be custom-built using the GraphQL Storefront API | | [Gift Wrapping](https://support.bigcommerce.com/s/article/Gift-Wrapping) | 🟡 | | | Masquerading / Login as Customer | 🟡 | | | Order Downloads | 🟡 | Use custom digital product fulfillment pipeline. Like agencies do for Stencil today. | | Order Tracking Links | 🟡 | | -| Product Videos | 🟡 | | | [Saved Payment Methods](https://support.bigcommerce.com/s/article/Enabling-Stored-Payment-Methods) | 🟡 | | | Sitemap | 🟡 | Catalyst does generate a sitemap for you, but it does not factor in routes that are not managed by BigCommerce. For example, it does not include routes that are created in Makeswift | | In-app search | 🟡 | Catalyst does support search for BigCommerce products, but it does not factor in content that is not managed by BigCommerce. For example, it does not include content that is created in Makeswift | | Session Syncing | 🟡 | Session can be synced from a headless storefront to a Stencil checkout. For example: you log in/out in headless then redirect to checkout. Session cannot be synced from a Stencil checkout to a headless storefront. For example: you log in/out in Stencil then redirect back. For more details, refer to the [Session Sync documentation](/docs/storefront/catalyst/development/session-sync). | +| [Scripts Manager](https://support.bigcommerce.com/s/article/Using-Script-Manager) | 🟡 | Although we don't think frontend script injection is the right way for most solutions to integrate into Catalyst - we think most people would be better served by writing Server Components - we have added Scripts into GraphQL Storefront API so they can be rendered in Catalyst when it does make sense, such as for analytics pixels. It's important to note that scripts with handlebar expressions built for Stencil will not work in Catalyst.| | [ADA Compliance](https://support.bigcommerce.com/s/article/Accessibility-ADA-Compliance) | 🟢 | Our new design system for 1.0 was developed with constant Lighthouse testing for accessibility, but we are also commissioning a 3rd party accessibility audit and we will address any findings from that auditor. The audit results are expected in February. | | [Cookie Consent for GDPR/CCPA](https://support.bigcommerce.com/s/article/Security-and-Privacy-Settings) | 🟢 | Added in [Catalyst 1.3](/docs/storefront/catalyst/release-notes/1-3-0)| | [Product Reviews](https://support.bigcommerce.com/s/article/Customer-Groups) | 🟢 | Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0) | @@ -48,10 +49,10 @@ Here is a list of BigCommerce platform features and whether or not they are supp | PCI Compliance | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | | [Persistent Cart](https://support.bigcommerce.com/s/article/Persistent-Cart) | 🟢 | Login mutation will be extended to automatically restore and merge carts just like Stencil. | | [Promotions](https://support.bigcommerce.com/s/article/Promotions-Video) | 🟢 | Promotional logic works in cart; some promo banners are not yet supported (separate item). | -| [Scripts API](https://support.bigcommerce.com/s/article/Using-Script-Manager) | 🟢 | Although we don't think frontend script injection is the right way for most solutions to integrate into Catalyst - we think most people would be better served by writing Server Components - we have added Scripts into GraphQL Storefront API so they can be rendered in Catalyst when it does make sense, such as for analytics pixels. | | Single Storefront Multi-currency | 🟢 | Added in #1912, only supports transactional currencies for now, not display-only currencies. | | Single Storefront Multi-geo | 🟢 | | | Single Storefront Multi-Lang | 🟢 | Supports: static string translation via language files, translated product catalog (either within a single channel, or across channels) via localized subpaths, uses next-intl as localization framework, localization of content pages when built with Makeswift using Makeswift's existing localization capabilities.

To learn more, check out our Catalyst Multi-Language Guide | | Synchronized login state between storefront and checkout; global logout | 🟢 | Enabled through Customer Access Token (CAT) used in Catalyst by default. | | Visual Editing (Page Builder equivalent) | 🟢 | As of 1.0 Makeswift is deeply integrated into Catalyst on a distributable version of Catalyst; customers have the choice of either using Makeswift or selecting a version of Catalyst with no editor built in. | | Wishlists | 🟢 | [Wishlist Catalyst documentation](/docs/storefront/catalyst/reference/wishlists) | +| Out of Stock Messages | 🟢 |Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0) | diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index 12165ecee..fe26f0ff2 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -35,9 +35,9 @@ Catalyst is BigCommerce’s headless and composable reference architecture for b * **GraphQL Storefront API Limitations:** - The GraphQL Storefront API that Catalyst depends on does not support all BigCommerce platform features * **Hosting:** - You are responsible for hosting your deployed storefront code * **App Marketplace** - Apps from the App Marketplace are not all supported -* **Themes:** - Catalyst does not provide a list of themes to choose from. However, you can customise the existing theme in code or by using Makeswift +* **Themes:** - Catalyst does not provide a theme marketplace to choose from. However, you can customise the existing theme in code or by using Makeswift -## Headless +## Custom Headless While Catalyst is a headless implementation, if you'd like to build a storefront using a different tech stack, you can do that as well. Building a headless storefront with BigCommerce’s GraphQL APIs enables a fast, flexible, and scalable ecommerce experience. By decoupling the frontend, you can use your preferred frameworks to create a dynamic, SEO-friendly site while BigCommerce powers commerce operations. The GraphQL Storefront API optimizes data fetching, improving performance and enabling seamless integrations. This modern, API-first approach allows for personalized experiences, custom checkout flows, and easy third-party integrations. From 6e7f3d480aa7a38de54cbadcc46183eb5b83e49e Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 16:26:39 -0600 Subject: [PATCH 13/14] update wording on pci compliance --- docs/storefront/catalyst/features/supported-features.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/catalyst/features/supported-features.mdx b/docs/storefront/catalyst/features/supported-features.mdx index 44785b88c..0277d8c0c 100644 --- a/docs/storefront/catalyst/features/supported-features.mdx +++ b/docs/storefront/catalyst/features/supported-features.mdx @@ -46,7 +46,7 @@ Below is a list of major BigCommerce platform features, detailing what support e | My Account / Orders | 🟢 | Supports profiles, addresses, and order history. Tracking links not included yet; downloadable product links not supported. | | Native Analytics | 🟢 | We support three server-side sent events which are triggered in Catalyst middleware: visitStartedEvent, pageViewedEvent, and productViewedEvent. | | [Newsletter Subscription](https://support.bigcommerce.com/s/article/Collecting-Newsletter-Subscriptions?language=en_US) | 🟢 | Added in [Catalyst 1.4](/docs/storefront/catalyst/release-notes/1-4-0)| -| PCI Compliance | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | +| Secure payment handling (for PCI DSS compliance) | 🟢 | Today, no payments information touches the Next.js application due to the use of redirected checkout, so the Next.js layer is kept out of PCI scope for the most part. As we figure out the path to add Saved Payment Methods into the My Account area, we will approach this with an embedded/iframe based approach to provide similar guarantees. | | [Persistent Cart](https://support.bigcommerce.com/s/article/Persistent-Cart) | 🟢 | Login mutation will be extended to automatically restore and merge carts just like Stencil. | | [Promotions](https://support.bigcommerce.com/s/article/Promotions-Video) | 🟢 | Promotional logic works in cart; some promo banners are not yet supported (separate item). | | Single Storefront Multi-currency | 🟢 | Added in #1912, only supports transactional currencies for now, not display-only currencies. | From 5ff4d650faa75ed581a2dfef596c012c2158ee16 Mon Sep 17 00:00:00 2001 From: jamesqquick Date: Thu, 15 Jan 2026 16:27:54 -0600 Subject: [PATCH 14/14] update wording on graphql api limitations with catalyst --- docs/storefront/choosing-a-storefront.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/storefront/choosing-a-storefront.mdx b/docs/storefront/choosing-a-storefront.mdx index fe26f0ff2..745de6e73 100644 --- a/docs/storefront/choosing-a-storefront.mdx +++ b/docs/storefront/choosing-a-storefront.mdx @@ -32,7 +32,7 @@ Catalyst is BigCommerce’s headless and composable reference architecture for b ** Limitations of Catalyst:** -* **GraphQL Storefront API Limitations:** - The GraphQL Storefront API that Catalyst depends on does not support all BigCommerce platform features +* **GraphQL Storefront API Limitations:** - The GraphQL Storefront API that Catalyst depends on does not support all BigCommerce platform features which means some features are not supported out of the box in Catalyst * **Hosting:** - You are responsible for hosting your deployed storefront code * **App Marketplace** - Apps from the App Marketplace are not all supported * **Themes:** - Catalyst does not provide a theme marketplace to choose from. However, you can customise the existing theme in code or by using Makeswift