Release notes

Enhancements & Fixes

• Event handling: Updated the cart and payment account page to replace inline event handlers with event listeners. #2536

• Multiple date field support: Enhanced Cornerstone to support multiple date fields while removing unnecessary blank spaces for a cleaner UI. #2533

• Wallet buttons: Improved logic for showing/hiding available wallet buttons on the product detail page (PDP). #2532

Announcement

• Validation for channel_id in POST/PUT /v2/orders

  The v2 Orders API now validates the channel_id field in both the Create an Order and Update an Order endpoints. Previously, invalid or non-existent channel_id values were accepted without error, potentially leading to data integrity issues. With this update, passing an invalid channel_id will result in a 400 error, ensuring better data hygiene.

API Updates

• Platform Limits - Added platform limits for the Inventory Adjustments and Locations APIs.

• JWT Session-Sync Limits - Added a note regarding the number of invalid session-sync JWT tokens allowed before the system blocks an IP address. See the Headless/GraphQL account login section for details.

Catalog Updates

• Best practices for Channel Assignment endpoint - Added best practices for using the Create Products Channel Assignment endpoint.

• New endpoint - Added the Get All Bulk Pricing Rules endpoint.

• Category trees usage notes & limits - Clarified the Create Categories depth limit and corrected the requirement for upserting category trees.

Checkout Updates

• New fields - Added custom_checkout_sri_hash and custom_order_confirmation_sri_hash to Get and Put Checkout Settings endpoints to allow merchants to provide a SRI hash for their custom checkout.

B2B Updates

• B2B Storefront Auth Token API response - Updated documentation to reflect that the Get a B2B StorefrontToken API returns a token as an array of strings, not a single string.

  

Stencil Updates

• Added handlebar helper - Added getImageSrcset1x2x to the list of available Custom helpers.

Enhancements & Fixes

• Removed an outdated note from the Get Email Templates and Get an Email Templates endpoints.

• Reorganized sections in the Orders Overview to reflect when tracking information becomes available.

• Corrected schema details for store/order/transaction/created.

• Fixed various broken links in the developer documentation.

Stencil

• Handlebars partial blocks for Stencil

  Stencil now supports Handlebars partial blocks, enabling merchants to leverage the latest handlebar features and best practices for enhanced flexibility and performance.

  

Unified Billing

• Unified Billing OAuth Scopes

  We’ve updated the OAuth scopes table to provide an accurate reflection of scope behavior.

Webhooks

• Webhook security update

  We’ve enhanced webhook security with a new verification header that uses the Standard Webhooks protocol. This header replaces previous security methods, such as authentication headers. Each webhook event is signed with the client secret, and you can verify its authenticity using the provided libraries.

Platform Limits

• URL & concurrent limits

  • Added URL character limits to the POST and PUT Product images endpoints.

  • Added concurrent limits to the POST and PUT Segments, and POST Shopper profiles to a segment endpoints.

Enhancements & Fixes

• Added a ttl object to the shipping rates response body.

• Added enum values for the consents array in the POST and PUT endpoints for subscribers v3.

Developer Blog

• Platform Updates: January 2025

  Stay informed with the latest platform updates and improvements.

API

• Cursor Pagination for getCustomers

  Cursor pagination is now available in the Customers V3 API for both the Get All Customers and Get Customer Form Field Values endpoints. This update improves navigation performance and supports many customers or form field values.

GraphQL

• Storefront GraphQL supports bi-directional pagination

  The Storefront GraphQL API fully supports bi-directional pagination, which improves performance when handling large datasets and enhances the overall user experience.

Unified Billing

• SubscriptionsQuery scope filter

  We’ve added a new filter to the SubscriptionQuery, allowing users to filter by scope. This filter reduces the need to manually track a store's subscriptions, helping partners streamline and reduce admin overhead. Note: We also added a new Requirements and limitations section for Partners.

Stencil

• New channelUrl parameter for stencil start

  We've added the channelUrl  parameter to the stencil start command. This parameter allows users to directly configure a BigCommerce domain, bypassing custom domain protections for users with a proxy or DNS settings that block requests from Stencil CLI.

Catalyst

• Localization updates

  We’ve updated the Catalyst Internalization guides to walk you through how to translate content into multiple languages on a single storefront and how to localize your store for multiple countries using multiple storefronts. For an overview, see the Internationalization overview.

Developer Blog

• How Fast Simon Used AI to Improve Francesca’s Search & Filter Implementation

• BigCommerce for Wordpress (BC4WP) Documentation Update

• Breaking Change Announcement: Update to v2 Orders API Side-Loadable Consignment Response August 2025

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

• Add nonce to scripts in checkout and account pages. #2525

• Remove the escaping of the “=” symbol for <head>. #2526

• Add Karla 700 font weight to schema.json and remove italic versions. #2522

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

• Fix color value for carousel play-pause button. #2509

• Bulk pricing model on PLP, only displays information for the first product. #2501

• 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

• Updated check for showing/hiding available wallet buttons on PDP. #2532

• 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

• Add support Node 20. #2519

• 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

• Cornerstone update to support multiple date fields and remove blank space. #2533

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!