Release notes

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

API

• We’re happy to announce that you can create shipping methods specific to a storefront channel to help you localize your storefront when selling internationally and across customer segments.

• We’ve added a fee item type to Refund endpoints of the Orders API to represent order-level fees like package insurance, gratuities/tips, and credit card fees. To see an example request, see Creating refund quotes.

• Configuring the headless checkout URL with www_redirect settings is now available using the Settings API.

Catalyst

• We’ve integrated Customer Access Tokens into the main branch of the Catalyst repository.

Enhancements

• Added documentation surrounding the multiConcat handlebar helper. Thanks, Andrew Barber.

• Added the security.md file so security researchers know where to report a vulnerability found on this repository.

• Added a note to clarify that orders created through the V2 Orders API will not result in an order notification email being sent to the customer.

• Added a note to clarify that total_sold on products for imported orders will remain unaffected if the external_source value is M-MIG.

• Updated the required node and npm versions for Installing Stencil CLI to 20.16.0.

• Added introductory information to the Settings API documentation.

Bug Fix

• We replaced the code field with paymentCode in the Get Payments of Store B2B endpoint response body. Thank you, bbogovich-vs.

API

• Added an optional token field in the storefront Create a Customer request body.

• Added an order_pickup_method_id field to the Get All Order Taxes endpoint.

Enhancements

• A phone:in query parameter was added to the Get All Customers endpoint.

• New query filters were added to the Get Redirects endpoint.

• Reordered sections in the Customizing invoices article to increase readability.

Bug Fixes

• Added the missing giftcertificate option for the type field in the List Order Products endpoint.

• Corrected purchase_date and expiry_date date formats in the Gift Certificate API response examples.

• Updated the example queries in the GraphQL Storefront API Orders (Beta) article.

• Corrected inaccurate examples and request fields for the Create a Product Image endpoint.

Developer Blog

• Simplify Your App Billing: Introducing BigCommerce’s Unified Billing!

API

• Store metafields are now available to use. Add metafield data to a merchant’s store using this set of APIs. Metafields can be created, updated, and deleted on stores.

• We’re happy to announce that trusted proxy enablement is available for headless merchants and merchants behind a proxy.

• Added the trigger_account_created_notification field as a request parameter for the Create Customers endpoint.

• We’ve added country_code (alpha-2) to the /v3/pricing/products endpoint in support of tax geolocation for shoppers outside the default tax zone.

Enhancements

• Added a 422 error response body to the Create Channel Menus endpoint.

• Added additional query parameters to the Get Subscribers endpoint.

• Added default and alternate behavior information to the Locations article.

• Added details to the Create Order Shipment endpoint regarding tracking_carrier.

Cornerstone 6.15.0

• Adding mobile nav dropdown focusTrap. #2465

• Remove remote_api_scripts to avoid double firing Meta Pixel analytics. #2467

• Prevent flow outside page container on account pages. #2462

• Account.js - Fixed jQuery selector to be template literal. #2464

• Address deprecated jQuery methods. #2466

• Load other font weights and styles for the body-font. #2396

Enhancements

• Clarified the need to enter a JSON formatted string for Shipper HQ metafields for product metafields and product variant metafields.

• Added error codes to the Get all customers and Delete customer endpoint descriptions. Thank you @sshaw.

Bug Fix

• Removed brackets to correct the Update a metafield request body for the Customers V3 API.

API

• The Upsert Customer Form Field Values endpoint is now deprecated. Use Update a Customer Address and Update Customers endpoints instead.

Developer Blog

• Script Authorization on Payment Pages: Understanding PCI 4.0 Section 6.4.3 and How We’re Providing The Tools To Keep Your Payment Pages Secure