Breaking change: UI extensions on versions
2023-10 or older that use either the
purchase.checkout.shipping-option-list.render-before or the
purchase.checkout.shipping-option-list.render-after will no longer render if the checkout contains both a one time purchase and subscription item.
purchase.checkout.shipping-option-list.render-after will be duplicated for possible types of delivery groups (One Time Purchase and Subscription). You can use the new
ShippingOptionListApi to target each delivery group in your extension.
The delivery group the extension is attached to will be passed as a
target. In React, you can also use the
useDeliveryGroupTarget() hook to retrieve the current delivery group. The target will be
undefined if the group is not available, for example when the buyer hasn’t entered an address on One-page checkout, or when shipping is unavailable for this address.
We’re also introducing a new unique
id on a
DeliveryGroup to identify each delivery group.
If your extension is capturing buyer inputs at Checkout and storing the information in a metafield, you can use checkout attributes with a namespaced key to capture information for multiple delivery groups rendered on Checkout. See examples.
These changes can be tested today using the Checkout Extensibility developer preview using the
unstable api version.
Learn more about these API changes on shopify.dev