DocsStorefrontCatalystRelease Notes

Catalyst version 1.8.0 release notes

Catalyst 1.8.0 adds tax-display support, honors store owner-configured locale URL paths, improves consent-aware cookies, and includes storefront fixes for backorders and WYSIWYG media. This release also includes @bigcommerce/create-catalyst@1.1.0, which deprecates the legacy integration command. For a full list of Catalyst changes, see the changeset on GitHub.

Tax display settings

Catalyst now honors the store’s Tax Display setting from the BigCommerce control panel across product detail page (PDP), product listing page (PLP), search, compare, and home page product experiences.

Supported display modes include:

  • Inc. Tax - prices render with tax included
  • Ex. Tax - prices render with tax excluded
  • Both - prices render as stacked included-tax and excluded-tax values, each with its own label

Sale price strike-throughs are also rendered per tax line when the storefront displays both tax-inclusive and tax-exclusive prices.

Migration

Pricing was refactored end-to-end to support included-tax, excluded-tax, and combined display modes. If you maintain a fork with pricing customizations, review and reconcile changes to the pricing GraphQL fragments, pricesTransformer, shared price types, page-data settings queries, and analytics helpers.

Locale URL paths

Catalyst now consumes store owner-configured per-locale URL subfolders from the BigCommerce Storefront GraphQL API’s Locale.path field.

The locale that resolves at the bare root URL (/) is derived from the control panel configuration:

  • If the default locale has no path, the default locale sits at /
  • If the default locale has a path and exactly one non-default locale has no path, that non-default locale sits at /
  • Otherwise, every locale receives a URL prefix

Locales with configured paths use those paths. Locales without configured paths fall back to their locale code.

Migration

If your storefront has custom locale routing, redirects, navigation, canonical URL logic, or hardcoded assumptions that the URL prefix always matches the locale code, update those customizations to account for Locale.path.

Catalyst 1.8.0 includes several cookie updates for consent and Essential cookie classification.

  • The consent manager cookie (c15t-consent) is now host-only. It is no longer scoped to the top-level domain for stores running on a subdomain.
  • catalyst.visitorId and catalyst.visitId now require measurement consent.
  • currencyCode now requires functionality consent.
  • Existing analytics cookies are deleted on the next request when consent is absent.
  • When measurement consent is granted during a session, Catalyst starts a new visit immediately instead of waiting for the next full-page navigation.
  • authjs.session-token and authjs.anonymous-session-token are now browser-session cookies without an Expires attribute.

Migration

If your storefront relies on the consent cookie being shared across subdomains, update that behavior in your customization. If your app relies on anonymous sessions persisting across browser restarts, restore a custom maxAge in your own anonymousSignIn call.

If you added a custom workaround to remove Expires from Auth.js session cookies, remove it. Catalyst now handles that centrally.

Storefront fixes and improvements

  • Backorders - variant backorder information now displays on product detail pages.
  • WYSIWYG media - images uploaded through the control panel editor now resolve correctly on headless storefront domains. Catalyst rewrites store-root-relative WebDAV paths such as /content/... and /product_images/... to absolute BigCommerce CDN URLs.
  • Version tracking - core/package.json now includes a catalyst field with catalyst.version and catalyst.ref. The backend user agent reports the true Catalyst version independently of the top-level package version, which merchants may use for their own deploy tagging.
  • Translations - static translations have been updated.

Makeswift integration

@bigcommerce/catalyst-makeswift@1.8.0 pulls in the Catalyst 1.8.0 storefront changes and includes Makeswift-specific updates:

  • Enables interaction-mode site navigation in the Makeswift builder
  • Fixes a 404 when switching between localized Makeswift pages with locale-specific paths and TRAILING_SLASH=true

create-catalyst 1.1.0

@bigcommerce/create-catalyst@1.1.0 deprecates the create-catalyst integration command. The command is now hidden from --help and prints a deprecation warning when invoked.

The command still works for now, but it depends on building integration patches by diffing git tags. This approach won’t work once Catalyst projects are distributed as tarballs without git history. The command remains available during the transition to catalyst upgrade; full removal is reserved for a major version.

Release tags

Latest stable: