Add Customer Behavior Tracking Query, Enums, and Inventory Transfer Filters

4/25/2026, 12:00:49 AM

Shopify now exposes a new query called customerBehaviorTrackingPreference that returns the merchant’s chosen data sharing level via the CustomerBehaviorTrackingPreference type. The new enum CustomerDataSharingLevel introduces four levels – DISABLED, CONSERVATIVE, ENHANCED, and MAXIMUM – which are used by the aforementioned query. The InventoryTransfer type received two field updates: lineItems and lineItemsCount now support an optional inventoryItemIds filter (a list of IDs) in addition to the existing pagination parameters. An additional enum value, PROCESSING_FAILED, has been added to BillingAttemptUserErrorCode to represent payment processing errors. A new webhook topic, CUSTOMER_BEHAVIOR_TRACKING_PREFERENCES_UPDATE, was added so apps can react to changes in sharing preferences. Together, these changes enable developers to query and monitor customer behavior tracking settings and filter inventory transfer line items more precisely.

Query Changes

➕ Added Queries (1)

customerBehaviorTrackingPreference

Returns the configured customer behavior tracking preference.

Type Changes

➕ Added Types (2)

🏗️CustomerBehaviorTrackingPreference➕ AddedOBJECT

The data sharing preferences set by the merchant.

Fields: dataSharingLevel
📋CustomerDataSharingLevel➕ AddedENUM

The data sharing level set by the merchant.

Values: DISABLED, CONSERVATIVE, ENHANCED, MAXIMUM

🔄 Modified Types (3)

🏗️BillingAttemptUserErrorCode🔄 Modified
Enum value added: PROCESSING_FAILED
🏗️InventoryTransfer🔄 Modified
🔄 Field modified: lineItems
🔄 Field modified: lineItemsCount
🏗️WebhookSubscriptionTopic🔄 Modified
Enum value added: CUSTOMER_BEHAVIOR_TRACKING_PREFERENCES_UPDATE