Release notes

API

• We're happy to announce the ability to query product videos using the storefront product graph.

• We have updated the API rate limits documentation, adding new methods for handling limits and optimizing requests.

GraphQL

• The GraphQL Storefront API's newly released CustomersSettings node has password complexity requirements that are now available. Now, when you register, update, or reset a customer's password, you can validate it before submitting the customer's desired password to the BigCommerce Platform.

Bug Fixes

• Added an expiration time for the cart redirect URL.

• Added missing information to product.yml and price.yml theme objects.

• Corrected Add Discount to Checkout request body example.

• Added an expiration time for the PAT token. See the Authorization header for details.

API

• We’re happy to announce the ability to apply multiple coupons on a cart using the Checkout V3 API.

• Batch metafields now include date_created and date_modified parameters. You can view this change for the following metafields:

  • Brand Batch Metafields

  • Categories Batch Metafields

  • Products Batch Metafields

  • Product Variants Batch Metafields

  • Customers Batch Metafields

  • Orders Batch Metafields

  • Channels Batch Metafields

  • Carts Batch Metafields

  • Locations Batch Metafields

GraphQL

• We are excited to announce that we have released a new geography node to the Storefront GraphQL API. Now, you can query an unfiltered list of countries.

Bug Fix

• Removed duplicate location_id parameter in locations.v3.yml. Thank you @smcc-riccardoc.

Themes

• We are happy to announce the newly released storefront selector feature in Stencil themes. Shoppers can now choose which storefront they want to browse when they visit your storefront.

GraphQL

• The Storefront GraphQL API now includes a statusMessage field under the Settings schema type. You can now have a customer-facing message associated with the current storefront status.

Bug Fixes

• Clarified the need for Stencil CLI, a local session, and a CSRF token to perform Checkout Storefront API requests.

• Defined the namespace for the GraphQL Create Cart Metafield mutation to alleviate confusion for merchants and developers. Thank you, @harnerdesigns.

• Removed restrictions for scripts on All Pages.

• Removed brand_name from the response body in the REST Management Catalog-Products API.

API

• We added the origin_channel_id to the list of read-only fields in the Customers V3 API. This field is set upon customer creation and cannot be updated afterward.

• The newly released Tax Settings API’s document_submission_strategy field lets you choose when to submit tax documents to third-party tax providers.

• We’re happy to announce the new store/modifier/updated webhook and the store/option/updated webhook, which fires when you update a modifier or variant option globally or for a channel.

• The new store/product/updated webhook fires when you update the product for a channel.

Announcements

• The bigcommerce/docs repo now contains the OpenAPI Specification files for promotions, inventory, locations, and other newer API features!

• The narrative documents’ source file structure in the bigcommerce/docs repo now matches the Dev Center URLs. Finding the document you want to modify is now easier than ever.

• The API reference source file restructure in the bigcommerce/reference repo is in progress. After completion, we will give all API client maintainers enough notice to reset your references.

Bug Fix

• Corrected the request body for the Create Cart redirect URL endpoint. Now, the request body will no longer throw errors.

Bug Fixes

• Corrected and improved Pages V2 (Deprecated) and Pages V3 specification files.

• Corrected and improved Categories and Category Trees specification files.

• Clarified that delivery exception hooks supersede the Get Events (Deprecated) endpoint. Thank you, @cjbarth, for submitting Issue 300.

API

• The Create an order shipment endpoint no longer supports UPSOnline as a shipper.

• The newly-released product review mutation is now available. Now, you can create product reviews through the built-in comment system using the GraphQL Storefront API.

• We are excited to announce Japanese language support. Now, BigCommerce’s Cornerstone Stencil theme supports uneditable strings in Japanese.

• We’ve added a new query parameter, transaction_id, in GET Refunds API endpoints.

• The GraphQL Storefront API now supports creating cart/checkout redirect URLs.

Announcements

• BigCommerce will deprecate support for Stencil CLI version 6 and older starting June 3, 2024. This decision is part of our ongoing efforts to ensure optimal performance and security for all platform users.

  Action required: To facilitate a smooth transition, we encourage you to upgrade to the latest version of Stencil CLI before the deprecation date. Upgrading ensures you and your team access the latest enhancements and features.

  How to upgrade: Run the following command in your terminal window to install the latest version.

  npm i -g @bigcommerce/stencil-cli

  If you have any questions or need assistance with the upgrade process, please don’t hesitate to contact our support team. We’re here to help ensure a seamless transition for your storefront.

• We’ve updated our list of dev support options to include the Resource Hub.

Bug Fixes

• Updated error responses and definitions for brands v3 endpoints.

• Corrected the Create a product variant response body example.

• Clarified the ambiguity around what it means to be a subscriber and added examples of POST/PUT requests for subscribers. See Customers and subscribers for details.

• Updated data type from array to string for the name:link parameter for Get All Price Lists.

• Removed duplicated parameters in the following openAPI operations. Thank you @smack-riccardoc!

  • customers.v3

  • orders.v2

  • themes.v3

  • widgets.v3

Cornerstone 6.14.0

• account.php is inside of a list item. #2457

• Screen reader only text must be provided. #2454

• Remove “cookie notification” JS and CSS. #2447

• Storefront navigation for switching between country-specific websites (step 1). #2453

• ADA Compliance - Accordion buttons are not read by screen reader correctly. #2441

• ADA Compliance - Region requires additional ARAI markup to assist screen reader users. #2435

• ADA Compliance - Add translations to accessibility attributes for Coupon Code and Gift Certificates. #2440

• ADA Compliance - The Add to Cart modal dialog container is not labeled. #2427

• ADA Compliance - Decorative SVG elements should be hidden from screen reader users. #2432

• ADA Compliance - Content that functions as a list should be indicated as such to screen reader users. #2429

• ADA Compliance - All form fields must be properly labeled. #2433

• ADA Compliance - Errors are not identified to screen reader users within the Refine By accordions. #2424

• ADA Compliance - Expandable items should be read by screen reader. #2422

• Page Suggested Items are still listed on Cornerstone. #2438

• Remove shop_by_price: true from category.html. #2431

• Added SEPA and ECP stored bank account types to the Payment methods page. #2434

• Added min-height for vaulted payment methods. #2455

API

• The REST Management API’s Update a checkout endpoint allows you to add a custom shipping method to the consignment ID. This feature allows you to create a manual order using this shipping method.

Bug Fixes

• We corrected our authentication documentation because the Customer login API had the wrong information for token creation. Users need store-level access to create a token. You must install the app on the store before creating a JWT.

• Added missing order_level_refund_amount field to the Create a refund quote response.

• Clarified the relation between the amounts needed to complete the refund in the Create refund quote endpoint.

Developer Blog

• Revolutionizing B2B Ecommerce: BigCommerce's B2B Edition Open Source Buyer Portal

API

• The newly released SRI hash feature is now available to use. Now, you can add SRI hashes to external SRC scripts.

• We’re happy to announce the include_fields query parameter on batch metafields, which can help you query specific enum fields. You can view this change for the following metafields:

  • Brand Batch Metafields

  • Categories Batch Metafields

  • Products Batch Metafields

  • Product Variants Batch Metafields

  • Customers Batch Metafields

  • Orders Batch Metafields

  • Channels Batch Metafields

  • Carts Batch Metafields

  • Locations Batch Metafields

Payments

• We're pleased to inform you that PayPal (Commerce Platform) now supports the storage of PayPal accounts with Braintree. This update brings added convenience and ease to your payment processes.

Bug Fixes

• Replaced the incorrect currency code in the Create a cart endpoint so merchants can use the sample code for Carts with 'custom item' without encountering an error.

• Fixed a broken category assignments link on the Channel webhooks page.

• Removed an incorrect statement in the Create cart redirect URL usage notes. You can create redirects for any cart, including one created with the GraphQL Storefront API.

• Fixed an incorrect example on the Update instruments endpoint.

API

• We’re happy to announce Promotions API is Generally Available (GA).

• The GraphQL Storefront API now supports cart metafields.

• Added a Localization document that describes how to localize a Catalyst storefront.

Webhooks

• The newly-released delivery exception webhook alerts users of delivery issues at their primary delivery destination.

Announcement

BigCommerce will deprecate support for Stencil CLI version 6 and older starting June 3, 2024. This decision is part of our ongoing efforts to ensure optimal performance and security for all platform users.

• Action required: To facilitate a smooth transition, we encourage you to upgrade to the latest version of Stencil CLI before the deprecation date. Upgrading ensures you and your team access the latest enhancements and features.

• How to upgrade: Run the following command in your terminal window to install the latest version.

  npm i -g @bigcommerce/stencil-cli

  If you have any questions or need assistance with the upgrade process, please don’t hesitate to contact our support team. We’re here to help ensure a seamless transition for your storefront.

Developer Blog

• Navigating the End of Third-Party Cookies: A Guide for BigCommerce App Developers

• Harness the Power of the Promotions API: Now GA!