Release notes

API

• The newly updated store/order/transaction/created webhook allows you to receive data for transaction_status, transaction_type, and result attributes.

Bug Fixes

• Updated the Webhooks Tutorial to change ngrok installation instructions.

• We’ve updated the cost_price field description to include how this field displays in the UI. See this field in the Create a Product Variant endpoint. Thank you, Pranay-Kumar-16, for bringing this issue to our attention.

API

• Merchants can now select which regions they want to use an automatic tax provider. To learn more about the new merchant flow, see configuring tax providers in the Tax Provider API doc.

Stencil

• Updated stencil category shop_by_price.yml description to include new functionality.

Bug Fix

• Removed duplicate listing of “Store Address” in Store information updated events.

API

• Added an End-to-end Guide for Headless checkout flow with the GraphQL Storefront API to describe how to work with shopper interactions on headless storefronts.

• The Management Checkout API now supports item-level and cart-level discounts.

• Updated the number of allowed domains for CORS to 2 for the GraphQL Storefront Tokens Create a Token endpoint.

Bug Fixes

• Revisited out-of-date screenshots in the Publishing an App article to provide the correct steps to certify an application.

• Made state_or_province required in the Add Consignment to Checkout and Create a Customer Address endpoints.

Bug Fixes

• Added missing fields (is_active and updated_at) to Get all themes and Get a theme endpoints.

• Added the missing consents array to the Subscribers API endpoints.

API

• The newly released price list and price list records webhooks are now available. Now, you can add events and use batch price lists and price list record events where appropriate.

• Added BigCommerce terms of service and privacy policy to endpoints, which included adding a product video, such as Create a Product Video.

• Updated the Create Categories endpoint to auto-generate category URLs from the category name when you don’t provide the URL.

• BigCommerce’s Storefront GraphQL now supports customer-specific mutations in a beta release. Access to customer data in the graph makes it easier for front-end developers to create customer-specific experiences for their headless storefronts as guest shoppers transition to registered customer accounts.

  Key use cases now supported by customer mutations are:

  • Register a Customer

  • Update a Customer

  • Add a Customer Address

  • Update a Customer Address

  • Delete a Customer Address

  • Change Password

  • Request a Password Reset

  • Reset Password

Bug Fixes

• Fixed incorrect schemas for the Create batch of price lists records endpoint. The previous schema returned a 400 response.

• Clarified vague text about the availability of stored PayPal accounts versus general wallet availability in the Payments API Overview.

• Fixed incorrect formatting of the example error message for GraphQL complexity limits.

Bug Fixes

• Updated the discount_amount definition in Checkout Coupons endpoints.

• Corrected the shipping consignment example in the Add Consignment to Checkout endpoint.

• Corrected the type for external_order_id query parameter in the Get All Orders endpoint.

• Added “read-only” and removed the enum of accepted values for tax_provider_id on OrdersV2 Create/update.

• Fixed a bug that shows duplication of default_currency_code and billing_address fields in the OrdersV2 API response body.

• The variants collection of product nodes now contains an SKU filter to filter the collection of variants by one or more SKU codes.

• Removed contradictory information regarding adding YAML front matter to the templates/pages subdirectory. Thank you Matt Coy from Arctic Leaf for assisting with this issue.

• We’ve updated the blog feature specification in Store Content to note that the is_published field defaults to false on both POST and PUT. Pass true to avoid reverting the post to draft status.

• We’ve clarified that some 422 errors in calls to the Channel Listings feature of the Management API include a group_id, which is the same as the listing_id of the request.

• We’re continuing to convert query params that provide comma-separated lists to unexploded form-style arrays, making generated API clients more efficient.

Developer Blog

• Composable Integration Series: Catalyst X Algolia

API

• Added the MPN filter attribute to Catalog Products endpoints. Thank you, Andrew Barber, at Space 48, for submitting Issue 126.

• Added recommendations for cursor-based pagination when iterating over a large number of coupons.

• The Big Open Data Layer now includes two newly-released events, load and update shopper consent. Now, you can send these events to 3rd-party analytics providers.

Bug Fixes

• Resolved incorrect variants array schemas in the Product Variants and Products endpoints.

• Added a missing field for the custom_url object schema for the Update a Product endpoint.

• Updated the url_zoom description to include the maximum image size for the Catalog Products endpoints.

• Fixed the description about option type set by default from radio buttons to rectangles in the Create variant using the product endpoint operation.

• Clarified the need to include a cart’s entityID when using the getCart query with customer impersonation tokens.

API

• Added the date_last_imported field to the product model. The field format is a nullable datetime string (e.g., “2024-01-24T14:36:56+00:00”). The field is modifiable and filterable.

• We’re happy to announce that you can add a set of query_parameters to the Create Cart Redirect URL when redirecting the shopper. For example, specifying query_params =[“utm_source” => “mailchimp”] in a request captures the utm_source parameter. When the shopper clicks on the redirect URL to proceed to the checkout page, the appended link will appear as /checkout?utm_source=mailchimp.

Bug Fixes

• Renamed the “Get All Metafields” reference titles to be more relevant to the resource type you want to retrieve and to prevent duplicate names across different schemas.

• We’ve updated the Creating Channels section of the Headless Guide to provide more clarity around the order of the steps in the channel creation process.

• The correct schema is now available for Create a Refund. Previous Request Body and Response Body examples displayed reason in the order level and items level.

• Added titles to Catalog response schemas. These changes will make return types more readable for users using our docs to generate clients.

• Changed primary_images to primary_image for the include query parameter for the Category API’s Get All Products endpoint.

Cornerstone 6.13.0

• Fix HTML markup for product listing and below content region. #2426

• With Product Filtering enabled widgets on the category page disappear after navigating using pagination. #2425

• Update layout with correct usage of main tag. #2421

• Anchor links on category pages are not working when product filtering is enabled. #2415

• Dispatch an event on productOptionsChanged. #2400

• Check lang helpers usage and the existence of a key in translation file. #2403

• Display fees on cart page. #2376

• Replace the Twitter logo with the X logo within social sharing and social link components. #2387

• Added nvm config. #2389

• Displaying the Hidden cart_order_source Input field on the PDP page. #2392

• Videos added through the Product Editor have their thumbnails cropped compared to videos added through the page builder. #2413

• Update Shop By Price Widget. #2408

• ‘Please Select a file’ popup forces the shopper to re-upload the file if the option type is ‘File Upload’ and is set to required. #2409

• Top Global Region Image Widget overlaps the mobile menu. #2402

• Changed default PayPal checkout button color. #2405

• Changed default PayPal checkout button size. #2406

• Change case of Page Builder menu item text. #2407

• Corrected typo with the word default previously deafault in config.json. #2410

• Adding autocomplete to common input fields. #2397

• Pre-Ordered text in Polish looks cropped in the button on Product page. #2414

• Use triple parentheses on the customer’s company name to prevent escaping ampersands. #2399

• Adding aria attributes to cart page coupon code and gift certificate buttons. #2391