Shopify · tjoyal · Jun 26, 2025 · Jun 26, 2025
diff --git a/checkout/javascript/cart-checkout-validation/default/schema.graphql b/checkout/javascript/cart-checkout-validation/default/schema.graphql
@@ -77,21 +77,25 @@ type BuyerJourney {
 }
 
 """
-Different steps in the buyer journey.
+A specific stage in the customer's purchasing journey that indicates where the customer is in the checkout
+process.
 """
 enum BuyerJourneyStep {
   """
-  Buyer is interacting with the cart.
+  The customer is interacting with the cart. For example, the customer is adding items to the cart
+  or removing items from the cart.
   """
   CART_INTERACTION
 
   """
-  Buyer is completing the checkout.
+  The customer is completing checkout. For example, the customer is reviewing their order before
+  finalizing the purchase.
   """
   CHECKOUT_COMPLETION
 
   """
-  Buyer is interacting with the checkout.
+  The customer is interacting with checkout. For example, the customer is adding their shipping
+  address or payment information.
   """
   CHECKOUT_INTERACTION
 }
@@ -137,6 +141,13 @@ type Cart {
   fulfillment by organizing items that can be shipped together, based on the customer's
   shipping address. For example, if a customer orders a t-shirt and a pair of shoes that can be shipped
   together, then the items are included in the same delivery group.
+
+  In the [Order Discount](https://shopify.dev/docs/api/functions/reference/order-discounts) and
+  [Product Discount](https://shopify.dev/docs/api/functions/reference/product-discounts) legacy APIs,
+  the `cart.deliveryGroups` input is always an empty array. This means you can't access delivery groups when
+  creating Order Discount or Product Discount Functions. If you need to apply discounts to shipping costs,
+  then use the [Discount Function API](https://shopify.dev/docs/api/functions/reference/discount)
+  instead.
   """
   deliveryGroups: [CartDeliveryGroup!]!
 
@@ -1763,8 +1774,9 @@ enum CountryCode {
 }
 
 """
-The three-letter currency codes that represent the world currencies used in stores. Currency codes include
-[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, and non-standard codes.
+The currency codes that represent the world currencies throughout the Admin API. Currency codes include
+[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, non-standard codes,
+digital currency codes.
 """
 enum CurrencyCode {
   """
@@ -1890,7 +1902,7 @@ enum CurrencyCode {
   """
   Belarusian Ruble (BYR).
   """
-  BYR @deprecated(reason: "`BYR` is deprecated. Use `BYN` available from version `2021-01` onwards instead.")
+  BYR @deprecated(reason: "Use `BYN` instead.")
 
   """
   Belize Dollar (BZD).
@@ -2415,7 +2427,7 @@ enum CurrencyCode {
   """
   Sao Tome And Principe Dobra (STD).
   """
-  STD @deprecated(reason: "`STD` is deprecated. Use `STN` available from version `2022-07` onwards instead.")
+  STD @deprecated(reason: "Use `STN` instead.")
 
   """
   Sao Tome And Principe Dobra (STN).
@@ -2492,6 +2504,11 @@ enum CurrencyCode {
   """
   USD
 
+  """
+  United States Dollars Coin (USDC).
+  """
+  USDC
+
   """
   Uruguayan Pesos (UYU).
   """
@@ -2510,7 +2527,7 @@ enum CurrencyCode {
   """
   Venezuelan Bolivares (VEF).
   """
-  VEF @deprecated(reason: "`VEF` is deprecated. Use `VES` available from version `2020-10` onwards instead.")
+  VEF @deprecated(reason: "Use `VES` instead.")
 
   """
   Venezuelan Bolivares Soberanos (VES).
@@ -2807,13 +2824,14 @@ A Function error for a path.
 """
 input FunctionError {
   """
-  Returns a message describing the error.
+  A description of the validation error. For example, "The product is out of stock" or
+  "The product isn't available for purchase in your region". The message is localized for the customer.
   """
   localizedMessage: String!
 
   """
-  Specifies the path/target for use by the UI. See [Supported checkout field targets](https://shopify.dev/docs/api/functions/reference/cart-checkout-validation/graphql#supported-checkout-field-targets)
-  for a list of supported targets.
+  The [identifier](https://shopify.dev/docs/api/functions/reference/cart-checkout-validation/graphql#supported-checkout-field-targets)
+  in `shopify.extension.toml` that specifies where you're injecting code in the checkout process.
   """
   target: String!
 }

diff --git a/checkout/javascript/cart-transform/default/schema.graphql b/checkout/javascript/cart-transform/default/schema.graphql
@@ -1694,8 +1694,9 @@ enum CountryCode {
 }
 
 """
-The three-letter currency codes that represent the world currencies used in stores. Currency codes include
-[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, and non-standard codes.
+The currency codes that represent the world currencies throughout the Admin API. Currency codes include
+[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, non-standard codes,
+digital currency codes.
 """
 enum CurrencyCode {
   """
@@ -1821,7 +1822,7 @@ enum CurrencyCode {
   """
   Belarusian Ruble (BYR).
   """
-  BYR @deprecated(reason: "`BYR` is deprecated. Use `BYN` available from version `2021-01` onwards instead.")
+  BYR @deprecated(reason: "Use `BYN` instead.")
 
   """
   Belize Dollar (BZD).
@@ -2346,7 +2347,7 @@ enum CurrencyCode {
   """
   Sao Tome And Principe Dobra (STD).
   """
-  STD @deprecated(reason: "`STD` is deprecated. Use `STN` available from version `2022-07` onwards instead.")
+  STD @deprecated(reason: "Use `STN` instead.")
 
   """
   Sao Tome And Principe Dobra (STN).
@@ -2423,6 +2424,11 @@ enum CurrencyCode {
   """
   USD
 
+  """
+  United States Dollars Coin (USDC).
+  """
+  USDC
+
   """
   Uruguayan Pesos (UYU).
   """
@@ -2441,7 +2447,7 @@ enum CurrencyCode {
   """
   Venezuelan Bolivares (VEF).
   """
-  VEF @deprecated(reason: "`VEF` is deprecated. Use `VES` available from version `2020-10` onwards instead.")
+  VEF @deprecated(reason: "Use `VES` instead.")
 
   """
   Venezuelan Bolivares Soberanos (VES).

diff --git a/checkout/javascript/delivery-customization/default/schema.graphql b/checkout/javascript/delivery-customization/default/schema.graphql
@@ -113,6 +113,13 @@ type Cart {
   fulfillment by organizing items that can be shipped together, based on the customer's
   shipping address. For example, if a customer orders a t-shirt and a pair of shoes that can be shipped
   together, then the items are included in the same delivery group.
+
+  In the [Order Discount](https://shopify.dev/docs/api/functions/reference/order-discounts) and
+  [Product Discount](https://shopify.dev/docs/api/functions/reference/product-discounts) legacy APIs,
+  the `cart.deliveryGroups` input is always an empty array. This means you can't access delivery groups when
+  creating Order Discount or Product Discount Functions. If you need to apply discounts to shipping costs,
+  then use the [Discount Function API](https://shopify.dev/docs/api/functions/reference/discount)
+  instead.
   """
   deliveryGroups: [CartDeliveryGroup!]!
 
@@ -1739,8 +1746,9 @@ enum CountryCode {
 }
 
 """
-The three-letter currency codes that represent the world currencies used in stores. Currency codes include
-[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, and non-standard codes.
+The currency codes that represent the world currencies throughout the Admin API. Currency codes include
+[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, non-standard codes,
+digital currency codes.
 """
 enum CurrencyCode {
   """
@@ -1866,7 +1874,7 @@ enum CurrencyCode {
   """
   Belarusian Ruble (BYR).
   """
-  BYR @deprecated(reason: "`BYR` is deprecated. Use `BYN` available from version `2021-01` onwards instead.")
+  BYR @deprecated(reason: "Use `BYN` instead.")
 
   """
   Belize Dollar (BZD).
@@ -2391,7 +2399,7 @@ enum CurrencyCode {
   """
   Sao Tome And Principe Dobra (STD).
   """
-  STD @deprecated(reason: "`STD` is deprecated. Use `STN` available from version `2022-07` onwards instead.")
+  STD @deprecated(reason: "Use `STN` instead.")
 
   """
   Sao Tome And Principe Dobra (STN).
@@ -2468,6 +2476,11 @@ enum CurrencyCode {
   """
   USD
 
+  """
+  United States Dollars Coin (USDC).
+  """
+  USDC
+
   """
   Uruguayan Pesos (UYU).
   """
@@ -2486,7 +2499,7 @@ enum CurrencyCode {
   """
   Venezuelan Bolivares (VEF).
   """
-  VEF @deprecated(reason: "`VEF` is deprecated. Use `VES` available from version `2020-10` onwards instead.")
+  VEF @deprecated(reason: "Use `VES` instead.")
 
   """
   Venezuelan Bolivares Soberanos (VES).

diff --git a/checkout/javascript/payment-customization/default/schema.graphql b/checkout/javascript/payment-customization/default/schema.graphql
@@ -113,6 +113,13 @@ type Cart {
   fulfillment by organizing items that can be shipped together, based on the customer's
   shipping address. For example, if a customer orders a t-shirt and a pair of shoes that can be shipped
   together, then the items are included in the same delivery group.
+
+  In the [Order Discount](https://shopify.dev/docs/api/functions/reference/order-discounts) and
+  [Product Discount](https://shopify.dev/docs/api/functions/reference/product-discounts) legacy APIs,
+  the `cart.deliveryGroups` input is always an empty array. This means you can't access delivery groups when
+  creating Order Discount or Product Discount Functions. If you need to apply discounts to shipping costs,
+  then use the [Discount Function API](https://shopify.dev/docs/api/functions/reference/discount)
+  instead.
   """
   deliveryGroups: [CartDeliveryGroup!]!
 
@@ -1739,8 +1746,9 @@ enum CountryCode {
 }
 
 """
-The three-letter currency codes that represent the world currencies used in stores. Currency codes include
-[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, and non-standard codes.
+The currency codes that represent the world currencies throughout the Admin API. Currency codes include
+[standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, non-standard codes,
+digital currency codes.
 """
 enum CurrencyCode {
   """
@@ -1866,7 +1874,7 @@ enum CurrencyCode {
   """
   Belarusian Ruble (BYR).
   """
-  BYR @deprecated(reason: "`BYR` is deprecated. Use `BYN` available from version `2021-01` onwards instead.")
+  BYR @deprecated(reason: "Use `BYN` instead.")
 
   """
   Belize Dollar (BZD).
@@ -2391,7 +2399,7 @@ enum CurrencyCode {
   """
   Sao Tome And Principe Dobra (STD).
   """
-  STD @deprecated(reason: "`STD` is deprecated. Use `STN` available from version `2022-07` onwards instead.")
+  STD @deprecated(reason: "Use `STN` instead.")
 
   """
   Sao Tome And Principe Dobra (STN).
@@ -2468,6 +2476,11 @@ enum CurrencyCode {
   """
   USD
 
+  """
+  United States Dollars Coin (USDC).
+  """
+  USDC
+
   """
   Uruguayan Pesos (UYU).
   """
@@ -2486,7 +2499,7 @@ enum CurrencyCode {
   """
   Venezuelan Bolivares (VEF).
   """
-  VEF @deprecated(reason: "`VEF` is deprecated. Use `VES` available from version `2020-10` onwards instead.")
+  VEF @deprecated(reason: "Use `VES` instead.")
 
   """
   Venezuelan Bolivares Soberanos (VES).