![decorative graphic](/_next/image?url=https%3A%2F%2Fstorage.googleapis.com%2Fbigcommerce-production-dev-center%2Fimages%2Frelease-notes-graphic.png&w=1080&q=75)
Release notes
Your bookmark friendly source for BigCommerce platform updates and enhancements.
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for January 30, 2025
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 forstencil 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
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for January 23, 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.
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
Cornerstone 6.16.0 for January 20, 2025
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
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for January 17, 2025
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
andshipping_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 thecontrol_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.
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for January 9, 2025
API
Fixed the webhook documentation for options and modifiers. You can only trigger the
store/option/updated
andstore/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 tofieldValue
in the Quote API due to changes related to migrating the quote extra fields to the unified extra fields module. Thevalue
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.
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for January 2, 2025
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.
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for December 19, 2024
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
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for December 12, 2024
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
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for December 5, 2024
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.
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
![author-avatar](/_next/image?url=https%3A%2F%2Fstorage.noticeable.io%2Fusers%2FxN75DnTO3xSM2G2LlhveYrqub9V2%2F01h55ta3gsd64qhqbnd0dcqsww-avatar.jpg&w=64&q=75)
API Updates for November 21, 2024
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.