Changelog

Cascading price lists have moved out of closed beta and are now available to the public in open beta, with no access request required.

• Layer fallback pricing: use the layers field on a price list to define a fallback list that resolves when a price record is not found in the primary list, before falling back to the catalog price.
• Standard Price Lists endpoints: the layers field is set on the existing create and update Price Lists API endpoints. No new endpoints are introduced.

Authenticated customers can now access B2B company data through the Storefront GraphQL API.

The Storefront GraphQL schema exposes the default product sort order used on search listings.

New fields across the Storefront and B2B GraphQL schemas.

Cornerstone 6.20.0 expands backorder and stock-availability messaging across the product page, cart, and account order pages, adds support for bundled (picklist) item inventory, refines the cart shipping layout, and delivers accessibility and bug fixes.

• Respect available_to_sell — Hides the Sold Out alert and keeps Add to Cart enabled for backorderable products, and disables Add to Cart with a “maximum purchasable quantity” message when the requested quantity exceeds available_to_sell (for both simple products and variants)
• Support unlimited_backorder — Renders the backorder quantity message and availability prompt, and lifts the Add to Cart quantity cap, for products with unlimited backorder
• Backorder quantity message when clamped — Shows the “N will be backordered” message when the requested quantity exceeds available_to_sell (still clamped by available_for_backorder), so shoppers see why the quantity was clamped alongside the “maximum purchasable quantity” message
• Backorder prompts for picklist products — Renders backorder prompts for picklist (bundled) products on the PDP
• Picklist stock validation — Validates each selected picklist item’s available_to_sell so Add to Cart is disabled and a “maximum purchasable quantity for {item} is {qty}” message is shown when the requested quantity exceeds that item’s stock, even when the main product still has enough stock

Checkout promotions now expose their discount breakdown in the Storefront GraphQL schema, and B2B quotes gain a to-be-determined total flag.

The Catalyst CLI (@bigcommerce/catalyst) reaches 1.0.0 as a single tool for scaffolding, building, deploying, and maintaining your storefront, and Native Hosting moves from closed alpha to closed beta. Install the CLI from the @latest tag instead of @alpha.

• Consolidated CLI — @bigcommerce/catalyst@1.0.0 unifies scaffolding, authentication, project and channel management, build, deploy, logs, and upgrades into one command-line tool, published to the npm @latest tag.
• create-catalyst 2.0.0 — pnpm create @bigcommerce/catalyst now delegates to catalyst create. The standalone init, integration, and telemetry subcommands are removed; use catalyst channel link and catalyst telemetry instead.
• Custom domains — add, list, check the status of, and remove custom domains for a Native Hosting project with catalyst domains.
• In-place upgrades — catalyst upgrade moves a project to a newer version through a 3-way merge, writing standard conflict markers instead of ever aborting.
• Historical logs — catalyst logs query retrieves past log entries over a time window, complementing the real-time catalyst logs tail.

Customers can now retrieve their stored payment instruments through the Storefront GraphQL API, plus a new top-level category search filter and a translatable brand URL path resource.

The Catalyst CLI adds a logs query command that retrieves historical logs from your deployed application over a time window of up to 7 days.

• Flexible time windows — use --since for a relative window or --start/--end for absolute UTC timestamps
• Targeted filtering — narrow results by --method, --status-code, --url-like, and --level-min
• Output controls — set --limit (up to 500) and pick a --format (json, pretty, default, short, request)

Catalyst v1.8.0 is now available, along with @bigcommerce/create-catalyst@1.1.0.

• Tax display settings - Catalyst now honors the store’s Tax Display setting (Inc. Tax, Ex. Tax, or Both) across product detail, product listing, search, compare, and home page product experiences.
• Locale URL paths - Catalyst now reads store owner-configured Locale.path values from the Storefront GraphQL API, so locale subfolders can follow the control panel configuration instead of always using the locale code.
• Consent-aware cookies - visitor, visit, and currency cookies now respect shopper consent, and Auth.js session tokens are now browser-session cookies without an Expires attribute.
• Storefront fixes - variant backorder information displays on PDPs, WYSIWYG images resolve correctly on headless domains, and Catalyst now tracks its true release version in core/package.json.
• Makeswift updates - @bigcommerce/catalyst-makeswift@1.8.0 includes Catalyst 1.8.0 and adds interaction-mode site navigation in the Makeswift builder.
• create-catalyst deprecation - create-catalyst integration is now deprecated, hidden from --help, and remains available during the transition to catalyst upgrade.

B2B company users can now update their own account settings through the Storefront GraphQL API. This mutation is rolling out gradually and may not be available on all stores yet.

The Create a Cart and Add Cart Line Items endpoints now include an Overridable fields table that explicitly lists the catalog values you can override when adding line items to a cart.

• list_price — override the product’s price (with a note on promotion eligibility)
• name — override the product name for locale-specific display
• option_selections.name — override an option or modifier label
• option_selections.value — override an option or modifier value

The Catalyst CLI adds a channel link command that connects a Catalyst project to a BigCommerce storefront channel and writes its credentials to .env.local.

• Interactive onboarding — logs you in through the browser device-code flow when you aren’t authenticated, then prompts you to pick a storefront channel
• Non-interactive mode — pass --store-hash, --access-token, and --channel-id to skip the prompts
• Extra variables — use --env KEY=VALUE (repeatable) to append values to .env.local

Per-line-item tax totals on cart items, plus a new translatable category URL path resource.

We’ve added a dedicated AI Agent Setup page that walks you through connecting the BigCommerce developer docs to your AI tool — so it can answer questions grounded in our documentation instead of guessing.

• One-click install for Cursor and Claude Code via the Copy page dropdown in the upper-right of any docs page
• Manual setup snippets for Cursor, Claude Code, Codex, and Claude Desktop
• Bottom-pinned sidebar link on every tab so the page is reachable from anywhere on the site

We’ve clarified that custom cart items don’t support images. The image_url field on a custom item is accepted by the API but does not render on the storefront.

• Carts v3 schemas — image_url descriptions on cart_PostCustomItem, ItemCustomGet, and ItemCustom now note that the field isn’t rendered for custom items
• Endpoint usage notes — added the limitation to the Create a Cart and Add Cart Line Items operations
• Request examples — removed misleading image_url values from custom item examples
• Headless carts guide — added a callout to the Working with carts page
• Checkout & Orders REST API course — added a note to the cart lesson

New error context fields and linked product types on the Storefront GraphQL schema.

Thanks to user feedback, we’ve corrected the Create a private token example on the GraphQL Storefront API authentication guide. The example request body now includes the required scopes field, matching what the POST /v3/storefront/api-token-private endpoint actually expects.

Thanks to your feedback, the header logo is now a site switcher. Click the logo at the top-left of any page to open a dropdown and jump straight to the Makeswift or Feedonomics docs without leaving your tab.

Keep the feedback coming.

The GraphQL for B2B course now covers authentication across both the BigCommerce GraphQL Storefront API and the B2B GraphQL API.

• Two GraphQL APIs — the course overview and introduction clarify that both the B2B GraphQL API and the standard GraphQL Storefront API support B2B operations.
• Authentication flows — the Authentication lesson walks through logging in with each API, including customer context, tokens, and exchanging a Storefront API session for a B2B token.
• Course prerequisite — recommends completing the GraphQL Storefront API course and links to it.