Deprecate Delivery Promise SKU Settings API

2/27/2026, 8:56:07 PM

The schema removes the entire Delivery Promise SKU Settings API, including the deliveryPromiseSkuSetting query, deliveryPromiseSkuSettingUpsert mutation, and the DeliveryPromiseSkuSetting and DeliveryPromiseSkuSettingUpsertPayload types, along with related error types such as PromiseSkuSettingUpsertUserError and its codes. Any existing code that queried or mutated SKU delivery promise settings must be updated to avoid using these deprecated fields, as they will be removed in a future version. Developers should look for new endpoints or alternative approaches to manage SKU‑level delivery promise settings within the API. Additionally, the ShopifyPaymentsBalanceTransaction type has gained a new field, adjustmentMetadata, which returns JSON metadata for adjustment‑type transactions or null otherwise. These changes imply that client applications should review their GraphQL queries, mutations, and type imports to ensure compatibility with the updated schema and to incorporate the new adjustmentMetadata data where relevant.

Query Changes

➖ Removed Queries (1)

deliveryPromiseSkuSettingdeprecated

A SKU setting for a delivery promise.

Mutation Changes

➖ Removed Mutations (1)

deliveryPromiseSkuSettingUpsert

Creates or updates a delivery promise SKU setting that will be used when looking up delivery promises for the SKU.

Type Changes

➖ Removed Types (4)

🏗️DeliveryPromiseSkuSetting➖ RemovedOBJECT

A delivery promise SKU setting that will be used when looking up delivery promises for the SKU.

Fields: deliveryPromiseProvider, scheduleHandle, sku
🏗️DeliveryPromiseSkuSettingUpsertPayload➖ RemovedOBJECT

Return type for deliveryPromiseSkuSettingUpsert mutation.

Fields: deliveryPromiseSkuSetting, userErrors
🏗️PromiseSkuSettingUpsertUserError➖ RemovedOBJECT

An error that occurs during the execution of PromiseSkuSettingUpsert.

Fields: code, field, message
📋PromiseSkuSettingUpsertUserErrorCode➖ RemovedENUM

Possible error codes that can be returned by PromiseSkuSettingUpsertUserError.

Values: BLANK, NOT_FOUND, TOO_LONG

🔄 Modified Types (1)

🏗️ShopifyPaymentsBalanceTransaction🔄 Modified
Field added: adjustmentMetadata

The metadata for the adjustment that's associated with the transaction.
If the source_type isn't an adjustment, the value will be null.