Release notes

API

• Customer SSO Support for Persistent Carts

  We are happy to announce the addition of Customer SSO (Single Sign-On) support for persistent carts. See the Customer Login JWT payload reference for more information.

Bug Fixes

• Updated the widgets per store limit from 10,000 to 100,000.

• Fixed broken links in the Shipping Methods endpoint documentation.

• Made table headings consistent in the Range Object - Properties tables for the Create a Shipping Method endpoint.

Cornerstone 6.16.0

• Remove the escaping of the “=” symbol for blog and brand. #2528

• Fix the product filter display name in the Show More modal window. #2510

• Adding missing product reviews form validation. #2475

• Support Stencil CLI’s ESM migration. #2500

• Add the missing icon for the JCB card provider in the saved payment methods. #2489

• Remove the supporting Apple Pay button stylization. #2491

• Fix GitHub build action, add package version, and short commit hash to artifact names in the GitHub Actions workflow for improved traceability and uniqueness. #2494

• Bump stencil-utils to 6.18.0. #2493

• Bump other GitHub Actions to fix warnings related to old versions. #2495

• Add a section to display the payment promotion widget in the drop-down of the cart preview. #2523

• Use fetch when updating variants in a cart. #2521

• Add a region to display the payment promotion widget on the category pages. #2530

• Rename the region to display the payment promotion widget on the category pages. #2531

API

• We are happy to announce you can manage languages across different channels. Using the GraphQL Admin API, merchants can add, update, or remove locales for each sales channel, change locale status, and set a locale as the default.

• When submitting a shipping cost for the POST and PUT v2 orders request, you must now include shipping_cost_inc_tax and shipping_cost_ex_tax in the payload. This change ensures accurate calculations and prevents negative shipping cost tax values.

Enhancements

• Removed the beta label since the Storefront Form Fields API is generally available.

• Removed the deprecated show_inclusive_in_control_panel field and added the control_panel_price_display_strategy field in the Tax Settings API.

• Added a 422 error response to the Update a product image endpoint.

• Added an “Avoiding infinite loops” section to our Tax Provider API guide to describe avoiding infinite loops. This topic has caused some disruption a handful of times over the years.

• Added clarification in the Get facets section of Faceted and Textual Search with the GraphQL Storefront API to prevent confusion when nodes return empty results.

Bug Fix

• Added and updated field limitations for the Create Categories endpoint.

API

• Fixed the webhook documentation for options and modifiers. You can only trigger the store/option/updated and store/modifier/updated webhooks by updating the option or modifier in the context of a channel and locale.

• We are happy to announce that you can now inspect where your tax provider connection is active. This information helps determine if there are outstanding steps in the merchant’s tax provider configuration. For more information, see the Tax App Connection API reference.

• Updated the v3/shipping/settings endpoint from POST to PUT as this endpoint updates settings.

• Added the out_of_zone_delivery_message field to update the out-of-zone delivery message that resides in v3/shipping/settings.

B2B

• The Get user extra field configs and Get quote extra field configs endpoints now support pagination, and we renamed the value field to fieldValue in the Quote API due to changes related to migrating the quote extra fields to the unified extra fields module. The value field remains backward compatible, so current implementations will not be interrupted.

Enhancements

• We’re happy to announce that we added an article describing how to Create Channels for your B2B headless platform.

• Added additional information to clarify cart metafields platform limitations.

• Added a note in the Tax Provider API reference and footnotes about document submission operations to alleviate confusion for tax integrators.

Announcement: Introducing cursor-based pagination for coupon codes

• The Get Coupon Codes endpoint now supports cursor-based pagination for improved query performance. As each store can support millions of coupon codes, it is a more efficient way to iterate through these very large datasets, significantly reducing response times.

  While existing implementations will continue functioning as usual, we recommend that integrations switch to cursor-based pagination for maximum benefits.

  We will begin to sunset offset-based pagination from 30 June 2025 to reduce maintenance costs and focus on fine-tuning the new standard. Please get in touch with support@bigcommerce.com for any questions.

API

• We’re happy to announce that you can now set information for product images in a channel locale. For more information, see International Enhancements for Multi-Storefront- Product images.

• We’ve exposed the display_name field of the promotion (for both coupon and automatic promotion) in v3 checkout, v3 carts, and storefront carts/checkouts APIs.

API

• The newly released custom order level fees are now available for use across both checkout and orders. You can apply and manage the order level fee via the v3 Management API for checkouts and via the v2 Management API for orders. Additionally, you can fetch any applied fees through the Storefront Checkout API.

Enhancements

• Added new Stencil CLI options to bundle and push to allow for source map inclusion in theme builds and a new section on theme optimization and source maps. Tools that provide automatic error reporting, session playback, and optimization suggestions can rely on source maps for more readable insight.

• Added Get an order metafield and Get metafields for a customer examples to the GraphQL Storefront API: orders(beta) document.

• Added additional attributes that trigger a product update webhook.

• Added a note to the Add to Cart URLs article to clarify that you need a product ID or SKU in the URL to add a coupon code.

Bug Fixes

• Corrected the discount_rules array of the v2 Customer Groups endpoint.

• Updated the maximum characters for an email from 255 to 250 when creating a custom account.

• Corrected the option_values array in the Product Modifiers endpoints.

Developer Blog

• BigCommerce API Update: Order Level Fees at Checkout Now Available!

API

• We’ve added a platform limit of 40000 zip-type shipping locations per store. Users can add up to 40000 zip-type locations to their store.

Enhancements

• Added information on how to set up an RSS feed for release notes.

• Added CustomerAccessToken as an optional parameter for the B2B Storefront Token endpoint.

• Updated the Stencil CLI installation instructions for a Mac.

• Clarified the description for the store/product/inventory/order/updated webhook when updating inventory.

• Added an example showing how a customer can log in to an embedded checkout using the session-sync URL. See the Customer single sign-on section for details.

• Updated the sku description for the Catalog Products API to clarify that the SKU has to be unique for products and variants regardless of the letter cases.

Bug Fixes

• Removed incorrect required label for variant_id from the Create a Cart, Add Cart Line Items, and Update Cart Line Item endpoint.

• Fixed broken links in the B2B’s Key resources section.

• Fixed incorrect link for Orders on the Metafields page.

Developer Blog

• BigCommerce API Update: Channel Filtering Now Available on GET ALL Products Endpoint

API

• We’re happy to announce that you can now retrieve channels to which a product is assigned when you get a product through the Catalog API. You can also filter products by the channel when you Get All Products.

GraphQL

• We added the ability to upgrade a guest cart to a customer cart as part of the login mutation. See the Signing customers in section for details.

B2B

• The following newly-released B2B endpoints for getting and selecting shipping rates on quotes are available to use.

  • Get available shipping rates for quote

  • Get custom shipping methods

  • Select a shipping rate for quote

  • Remove selected shipping rate for quote

Enhancements

• Added required tags to clarify that either a userId or customerId is needed to run the Get Shopping Lists query.

• Updated the description of key in the Widget Template API to prevent confusion.

• Added a 403 response error code to the Create Promotion endpoint.

Bug Fix

• Removed the limit of 40 concurrent requests because only adaptive limits are used for product endpoints.

Developer Blog

• How to (easily!) build a BigCommerce Marketplace App using Gadget

API

• We’re happy to announce that you can now use the Admin Graph to filter metafields by their date created or date modified.

Enhancements

• Updated the listPrice description in Add Cart Line Items and Update Cart Line Items endpoints to reflect that you can change the default behavior in the control panel.

• Added query parameters to the Get a Count of Orders endpoint.

• Added a note clarifying the “amount” should not be added to “item_type”:”PRODUCT” while creating refunds and refund quotes.

Bug Fixes

• Corrected the global.js file path in the Customizing display text section of B2B Edition for Stencil.

• Changed the limit of customer widget templates per store to 250. See Definitions for information.

• Updated the Delete Pages endpoint to allow the optional query parameter delete_children to replicate the same cleanup behavior in the control panel.

• Removed the incorrect “required” flags for the Update Products(Batch) endpoint to prevent confusion.

API

• We’re happy to announce the new line_items.coupon_amount field in the Big Open Data Layer for hosted storefronts, which indicates the coupon amount for a line item in a cart.

Enhancements

• Added missing concurrency rate limits to the Update Customers and Upsert Customer Attribute Values endpoints.

• Added information to clarify that the Create Cart Redirect URL endpoint only supports carts created using the REST management API or Storefront GraphQL API.

• Added a note to clarify that admins are the only role allowed to create API tokens using the B2B Get Server to Server Tokens endpoint.

Bug Fixes

• Updated the description for the company parameter for the Get Quote Form List endpoint to specify the parameter filters by company name, not company ID.

• Added the missing page parameter and pagination limits to the Get Product Sort Order endpoint and updated the response body.

• Corrected the Combined order status email object reference schema.

• Fixed a bug in the Big Open Data Layer documentation regarding which BigCommerce API field maps to line_items.discount.

• Added the missing Order ready for pickup email template.

• Updated the id field type from string to integer in the product theme object reference.

Developer Blogs

• What is Composable? Understanding E-Commerce Architectures

• Improving BigCommerce Documentation: Understanding an Audience from the Ground Up