Changelog

Shipping option selection strategy for checkouts in the GraphQL Storefront API

BigCommerce is rolling out an optional shippingOptionSelectionStrategy field on checkout shipping consignments in the GraphQL Storefront API, so a caller can have a shipping option selected by a strategy of its choosing instead of the store’s default shipping option setting. You may notice this take effect over the coming weeks.

• Choose a selection strategy. The createCheckout and updateCheckout mutations accept an optional shippingOptionSelectionStrategy on CreateCheckoutShippingConsignmentInput and ShippingConsignmentUpdateCheckoutInput. It takes a value of the new ShippingOptionSelectionStrategy enum: LEAST_EXPENSIVE, LEAST_EXPENSIVE_EXCLUDING_PICK_UP or MOST_EXPENSIVE.
• Overrides the store setting. When the field is provided, the shipping option is selected using that strategy, even if the store’s default shipping option setting would recommend a different one. isRecommended on the available shipping options still reflects the store setting, so the selected option may not be the one marked as recommended.
• One way to select per consignment. A request that sends shippingOptionSelectionStrategy together with selectRecommendedOption: true or shippingOptionEntityId is rejected.
• Omitting the field changes nothing. shippingOptionSelectionStrategy is optional, so existing mutations continue to work unchanged.

For details, see GraphQL Storefront API: Carts and Checkout.