For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LogoLogo
Dev Portal
DocsAPI ReferenceLearnCommunityChangelog
DocsAPI ReferenceLearnCommunityChangelog
Dev Portal
On this page
  • August 27, 2026
  • GraphQL Schema Updates
  • August 26, 2026
  • Catalyst upgrade keeps dependency versions current
  • Guidance for deleting all products
  • Wishlist breadcrumb URLs become absolute on September 26, 2026
  • August 25, 2026
  • Absolute breadcrumb URLs on Stencil order pages
  • Customer ID now factors into storefront tax display setting determination
  • August 24, 2026
  • Corrected B2B quote webhook payload example
  • New guidance on customer context in the GraphQL Storefront API
  • GraphQL Schema Updates
  • August 20, 2026
  • GraphQL Schema Updates

Changelog


August 27, 2026
August 27, 2026

August 26, 2026
August 26, 2026

August 26, 2026
August 26, 2026

August 26, 2026
August 26, 2026

August 25, 2026
August 25, 2026

August 25, 2026
August 25, 2026

August 24, 2026
August 24, 2026

August 24, 2026
August 24, 2026

August 24, 2026
August 24, 2026

August 20, 2026
August 20, 2026
Older posts
Next
Built with

GraphQL Schema Updates

The Storefront GraphQL API now exposes how a cart was created and its associated B2B company.

Storefront GraphQL

  • Cart origin and company: new source and companyId fields on the Cart type.
    • Source: source returns the new CartSource enum, indicating how the cart was created: B2B, B2B_INVOICE, B2B_QUOTE, or BUY_NOW.
    • Company: companyId returns the B2B company ID associated with the cart.

For schema details, browse the Storefront GraphQL API reference.

Catalyst upgrade keeps dependency versions current

catalyst upgrade now carries @bigcommerce/catalyst* dependency version bumps through its merge automatically, the same as any other package.json change.

  • Dependency versions move with the merge — a project pinned to a real semver range picks up the version the target release shipped, or surfaces a conflict if you pinned that dependency deliberately.
  • Projects still on workspace:^ get an opt-in migration prompt after the merge, offering to swap to the published version so future upgrades can keep it current the normal way.
  • New upgrade guide walks through prerequisites, running the command, recommended upgrade cadence, and how the dependency migration prompt works.

For details, see Upgrading and the Catalyst CLI reference.

Guidance for deleting all products

Thanks to user feedback, the Delete Products reference now explains how to clear an entire catalog.

  • Batch deletion pattern — the endpoint requires a filter and caps each request at 250 products, so the reference now documents the fetch-IDs-then-delete loop for removing every product.
  • Why the safeguards exist — the filter requirement and 250-product limit are intentional protections against inadvertent mass deletion, and the reference now says so.

For details, see Delete Products.

Wishlist breadcrumb URLs become absolute on September 26, 2026

Beginning September 26, 2026, breadcrumb links on Stencil wishlist details pages will use absolute URLs instead of storefront-relative paths.

  • What’s changing — Every item in {{breadcrumbs}} will return a url that includes the storefront scheme and domain. For example, a wishlist URL will change from /wishlist.php to https://www.example.com/wishlist.php.
  • Scope — The change applies to customer wishlist details pages and public wishlist share pages.
  • Action required — If your theme prefixes breadcrumb URLs with a domain or base path, remove that prefix and render {{url}} as-is. Themes that already render {{url}} directly, including the default Cornerstone breadcrumbs component, require no changes.

For the breadcrumb properties, see the Stencil object reference.

Absolute breadcrumb URLs on Stencil order pages

Breadcrumb links on the Stencil order status and order details pages now use absolute URLs instead of relative paths.

  • Order status page — On the customer’s orders list (page_type account_orderstatus), each item in {{breadcrumbs}} returns a url that includes the storefront scheme and domain, for example https://www.example.com/account.php?action=order_status rather than /account.php?action=order_status.
  • Order details page — The same change applies to a specific order’s details page (templates/pages/account/orders/details.html), for example https://www.example.com/account.php?action=view_order&order_id=1000000 rather than /account.php?action=view_order&order_id=1000000.
  • Why it matters — Absolute URLs resolve consistently regardless of the URL the page is served from, so the “Home / Your Account / Your Orders / Order #1000000” trail no longer produces broken links.
  • Scope — Other account pages, such as Addresses and Wish Lists, still return relative breadcrumb paths.
  • Action required — None for themes that render {{url}} directly, as the default Cornerstone breadcrumbs component does. If your theme prefixes {{url}} with a domain or base path of its own, remove that prefix.

For the breadcrumb properties, see the Stencil object reference.

Customer ID now factors into storefront tax display setting determination

When a storefront request carries a customer ID, the platform now uses it while determining the tax zone that governs tax display. This can change whether product prices appear including tax, excluding tax, or with both values.

  • What’s changing — Requests that include a customer ID may use it to determine the applicable tax zone instead of falling back to another determinant. Usage depends on store settings and if a customer address is available on their customer account.
  • When output differs — Only when the customer ID resolves to a tax zone that differs from the previously determined zone and that zone’s price display settings differ. Tax calculation itself is unchanged.
  • Where you’ll see it — Any storefront page that displays a product price, including product detail pages, category and search listings, and the cart.
  • Rollout — The behavior is off by default and enabled per store as the rollout progresses, so no store sees a change until it is turned on.

For how tax zones and their price display settings work, see Tax settings and Tax rates and zones.

Corrected B2B quote webhook payload example

Thanks to user feedback, the B2B Edition webhooks reference now shows the correct data object for quote events.

  • Quote payload now documents the fields the service actually sends: quote_id and quote_uuid. The previous example listed type and id, which quote webhooks do not return.

For details, see B2B Edition Webhooks.

New guidance on customer context in the GraphQL Storefront API

Thanks to user feedback, the GraphQL Storefront API docs now explain when and how an authenticated customer shapes a request.

  • New Customer Context page. A dedicated page covers how customer context works: how it can change a response (such as customer-specific pricing), when it’s required for an operation to work at all, and how to establish it client-side (session cookie) or server-side (the X-Bc-Customer-Access-Token header). It includes a reference table of known operations that require customer context, and holds the customer access token instructions previously kept on the Authentication page.
  • Overview callout. The GraphQL API Overview now flags that some operations depend on customer context even though the schema doesn’t show it, calling out non-obvious cases like registerCompany.

For details, see Customer context in the GraphQL Storefront API.

GraphQL Schema Updates

The Storefront GraphQL schema adds a way to list a store’s enabled payment methods and a display-friendly shipping provider name. These fields are alpha and marked deprecated in the schema: do not use them in production yet.

Storefront GraphQL

  • Enabled payment methods (alpha): the new paymentMethods connection on the Site type lists the payment methods enabled for the current store and channel, returned as the new PaymentMethod type (with entityId and name).
  • Shipping provider display name (alpha): the OrderShipment type adds shippingProviderDisplayName, a human-readable version of the existing shippingProviderName.
  • B2B company-user fields removed: the alpha companyUser query, the updateCompanyUser mutation, and the search filter on CompanyOrdersFiltersInput have been removed from the schema.

For schema details, browse the Storefront GraphQL API reference.

GraphQL Schema Updates

Authenticated customers can now delete a stored payment instrument through the Storefront GraphQL API. This mutation is an alpha release: the schema marks it deprecated with the reason “Alpha version. Do not use in production.”

Storefront GraphQL

  • Delete stored payment instruments: new deleteStoredPaymentInstrument mutation on the CustomerMutations type deletes a stored payment instrument for the authenticated customer.
    • Input: DeleteStoredPaymentInstrumentInput takes the token of the stored payment instrument to delete.
    • Result: DeleteStoredPaymentInstrumentResult returns an errors list of DeleteStoredPaymentInstrumentError; an empty list indicates success.

See the Customers guide for an example mutation, or browse the Storefront GraphQL API reference for schema details.