Starting in API version 2026-10, ShopifyQL adds Shop Campaigns fields to two schemas. The schema adds a metric and country and dimensions. The sales schema adds four Shop Campaign dimensions, so you can break down sales by the campaign that drove them.
What changed
The schema adds these fields:
| Field | Type | Description |
|---|---|---|
| Metric | Number of orders associated with Shop Campaigns. |
country | Dimension | Billing country for orders associated with Shop Campaigns. |
| Dimension | Two-letter ISO 3166-1 alpha-2 code for the billing country, such as US or CA. |
For example, this query returns campaign orders and ad spend by country for the last 30 days:
The sales schema adds these dimensions. Each one describes the Shop Campaign associated with the order:
| Field | Description |
|---|---|
| Name of the Shop Campaign. |
| Merchant-facing handle of the Shop Campaign associated with the order. |
| Name of the customer segment the campaign targeted, such as New customers. |
| Currency code for local monetary fields on the Shop Campaign order. |
These dimensions work with any sales metric. For example:
Sales from orders that aren’t associated with a Shop Campaign return null for these dimensions, so they appear as a separate null group in grouped results.
Who’s affected
Apps that run ShopifyQL queries on version 2026-10 or later. Queries on 2026-07 and earlier don’t include these fields.
What to do
No action is required. To use the new fields:
- Update your GraphQL Admin API requests to version 2026-10.
- Add the fields to your ShopifyQL queries.
- Test against a development store that has at least one Shop Campaign with orders.