---
title: >-
  Configure order attribution for sales channel apps - Shopify developer
  changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/order-attribution-definitions-are-available-in-order-channel-filters
  md: >-
    https://shopify.dev/changelog/order-attribution-definitions-are-available-in-order-channel-filters.md
metadata:
  effectiveApiVersion: 2026-07
  affectedApi:
    - displayName: Admin Extensions
      handle: admin-extensions
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Storefront GraphQL API
      handle: storefront-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-06-08T19:54:28-04:00'
  postedAt: '2026-06-30T12:00:00-04:00'
  updatedAt: '2026-06-26T17:48:17-04:00'
  effectiveAt: '2026-06-09T12:00:00-04:00'
---

June 30, 2026

Tags:

* Admin Extensions
* Admin GraphQL API
* Storefront GraphQL API
* 2026-07

# Configure order attribution for sales channel apps

Starting in API version `2026-07`, sales channel apps can use [order attribution definitions](https://shopify.dev/docs/apps/build/sales-channels/order-attribution) 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.
* Define static attribution sources with the `order_attribution_config` extension.
* Create or update attribution definitions with the [`orderAttributionDefinitionUpsert`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/orderAttributionDefinitionUpsert) mutation.
* Query attribution definitions with the [`orderAttributionDefinitions`](https://shopify.dev/docs/api/admin-graphql/2026-07/queries/orderAttributionDefinitions) query.
* Delete attribution definitions with the GraphQL Admin API.
* Pass an attribution definition handle when creating orders with `orderCreate`.
* Pass an attribution definition handle through `source_name` when creating carts with the Storefront API `cartCreate` mutation or when using [cart permalinks](https://shopify.dev/docs/apps/build/checkout/create-cart-permalinks).
* Read resolved attribution details with [`Order.attribution`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Order#field-Order.fields.attribution).

To use order attribution definitions, your app must be a sales channel app with a `channel_config` extension.

**What you need to do**

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`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Order#field-Order.fields.attribution) for new attribution reads. `Order.channelInformation` remains available, but is deprecated.