Configure order attribution for sales channel apps
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on June 30, 2026.
This Shopify update is categorized as API, New, Admin Extensions, Admin GraphQL API, Storefront API, 2026-07.
What changed
Starting in API version 2026-07, sales channel apps can use order attribution definitions to identify the source that created an order. Order attribution definitions are useful when your sales channel app needs attribution that is more specific than the app or channel itself. For example, you can attribute orders to a marketplace, region, account, or surface. Apps that only need default app or channel attribution don’t need to make any changes. What’s new Sales channel apps can now: Create channel-based attribution definitions when creating channel connections.
Who is affected
Apps and storefronts using the affected Storefront API surface should review this change.
What action may be needed
If your app needs attribution that is more specific than app-level or channel-level attribution, create order attribution definitions and pass the definition handle in sourceName when creating carts or orders. If sourceName doesn’t match an approved order attribution definition, Shopify falls back to app-only attribution. Use Order.attribution for new attribution reads. Order.channelInformation remains available, but is deprecated.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →