April 23, 2026

GraphQL Schema Updates

New fields, types, and enums across the Admin, B2B, and Storefront GraphQL schemas.

Storefront GraphQL

  • Built-in form field IDs — new BuiltInFormFieldId enum and builtInFieldId field on all form field types
  • Coupon staging — new CouponStatus enum (APPLIED, STAGED) and coupon fields on CheckoutCoupon
  • Checkout coupon inputscoupons field on CreateCheckoutInput and UpdateCheckoutDataInput
  • Shipping discountscostAfterDiscount on shipping options; OrderAutomaticShippingDiscount type and nonCouponDiscounts on consignments
  • Shipment line items — new OrderShipmentLineItem type and items field on OrderShipment
  • Inventory settingsshowDefaultShippingExpectationPrompt and defaultShippingExpectationPrompt fields
  • Store country codestoreCountryCode field on Settings

B2B GraphQL

  • Backorder display settings — new storefrontSettings query with BackorderDisplaySettingsType
  • Product backorder fieldsbackorderMessage, totalOnHand, quantityBackordered on ProductType and ProductInfoType
  • Order backorder snapshotbackorderSnapshot field on OrderType
  • Country state requiredstateRequired field on CountryType

Admin GraphQL

  • Translation resource typesINVENTORY_BACKORDER_AVAILABILITY_PROMPT, INVENTORY_DEFAULT_SHIPPING_EXPECTATION_PROMPT, and PRODUCT_URL_PATHS