Added storefront, estimated delivery, and carrier fields

20 August 2026

HTTP API

Enhancement

CartsOrdersProject configurationMessages/SubscriptionsGraphQL

Storefront URLs, delivery estimates, and carrier names are now available as standard API fields. These values were commonly modeled as Custom Fields when building agentic or headless checkout experiences. This enhancement allows you to provide these values while minimizing the number of Types and Custom Fields used in your project.

On a Store, the new storefront field groups customer-facing URLs and policy links. These include the checkout and order URL templates and links to policy pages such as terms of service, privacy, and refunds. For more information, see the Stores API.

On a Cart and Order, the new estimatedDelivery field on ShippingInfo records the time window during which a shipment is expected to be delivered. You can set it standalone with the new Set Estimated Delivery update action, or inline when selecting a Shipping Method. The estimate is cleared automatically when the shipping address changes.

On a ShippingMethod, the new carrier field records the name of the carrier that delivers the parcel.

Changes:

[API] Added the storefront field to Store and StoreDraft.
[API] Added the Storefront type.
[API] Added the Set Checkout URL Template, Set Order URL Template, Set Terms Of Service URL, Set Privacy Policy URL, Set Refund Policy URL, Set Shipping Policy URL, Set Cookie Policy URL, Set Imprint URL, Set FAQ URL, and Set Contact URL update actions to the Stores API.
[API] Added the StoreCheckoutUrlTemplateSet, StoreOrderUrlTemplateSet, StoreTermsOfServiceUrlSet, StorePrivacyPolicyUrlSet, StoreRefundPolicyUrlSet, StoreShippingPolicyUrlSet, StoreCookiePolicyUrlSet, StoreImprintUrlSet, StoreFaqUrlSet, and StoreContactUrlSet Messages.
[API] Added the EstimatedDelivery type.
[API] Added the estimatedDelivery field to ShippingInfo.
[API] Added the optional estimatedDelivery field to the Set ShippingMethod, Set Custom ShippingMethod, and Add ShippingMethod update actions of the Carts API.
[API] Added the Set Estimated Delivery update action to the Carts API and the Set Estimated Delivery update action to the Orders API.
[API] Added the CartEstimatedDeliverySet and OrderEstimatedDeliverySet Messages.
[API] Added the carrier field to ShippingMethod and ShippingMethodDraft.
[API] Added the Set Carrier update action to the Shipping Methods API.
[GraphQL API] Added the storefront field and the Storefront type to the Store and StoreDraft types.
[GraphQL API] Added the storefront set mutations to the StoreUpdateAction type.
[GraphQL API] Added the storefront Set Messages to the Store message types.
[GraphQL API] Added the estimatedDelivery field and the EstimatedDelivery type to the ShippingInfo type.
[GraphQL API] Added the setEstimatedDelivery input field to the CartUpdateAction and OrderUpdateAction types, and the optional estimatedDelivery input field to the setShippingMethod, setCustomShippingMethod, and addShippingMethod input fields.
[GraphQL API] Added the CartEstimatedDeliverySet and OrderEstimatedDeliverySet Messages.
[GraphQL API] Added the carrier field to the ShippingMethod and ShippingMethodDraft types, and the setCarrier input field to the ShippingMethodUpdateAction type.