Changelog

The Channels V3 API now accepts additional platform values for the marketing and marketplace channel types.

• New platforms — openai, paypal, and perplexity support both marketplace and marketing; reddit and snapchat support marketing
• Extended platforms — amazon, pinterest, and tiktok now support marketing in addition to marketplace

The Carts (V3) API reference now documents the is_custom_price property returned on cart line items.

• is_custom_price — a boolean on physical and digital line items that indicates whether the item’s price was overridden with a custom value using the list_price field.

For details, see the Get a cart endpoint reference.

The Promotions API adds two endpoints for managing the archive status of multiple promotions in a single request.

• Archive promotions — POST /promotions/archive accepts an array of promotion IDs and archives them.
• Unarchive promotions — POST /promotions/unarchive accepts an array of promotion IDs and restores them.

Authenticated B2B company users can now retrieve their company’s addresses through the Storefront GraphQL API, with pagination, filtering, and sorting.

Thanks to user feedback, the webhooks tutorial no longer assumes a single operating system and now reads correctly on macOS, Windows, and Linux.

• Platform-neutral setup — replaced macOS-specific commands with cross-platform equivalents and pointed ngrok installation at the official downloads page, with package-manager shortcuts for macOS and Windows.
• Clearer start steps — the tutorial now starts the Node.js app before ngrok and exposes the correct port.
• OS-agnostic troubleshooting — the “ngrok not found” guidance now covers PATH setup on both Unix-like systems and Windows.

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