---
title: >-
  New Shop Campaigns metrics and dimensions in ShopifyQL API version 2026-10 -
  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/posts/new-shop-campaigns-metrics-and-dimensions-on-api-version-2026-10
  md: >-
    https://shopify.dev/changelog/posts/new-shop-campaigns-metrics-and-dimensions-on-api-version-2026-10.md
metadata:
  effectiveApiVersion: '2026-10-01'
  affectedApi:
    - displayName: ShopifyQL
      handle: shopifyql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-10-01T14:25:40-04:00'
  postedAt: '2026-10-01T12:00:00-04:00'
  updatedAt: '2026-10-06T11:16:36-04:00'
  effectiveAt: '2026-10-02T12:00:00-04:00'
---

October 1, 2026

# New Shop Campaigns metrics and dimensions in ShopifyQL API version 2026-10

DateOctober 1, 2026

Version[2026-10-01](https://shopify.dev/changelog?api_version=2026-10-01)

FlagsNew

SurfacesAPI

Affected APIs[ShopifyQL](https://shopify.dev/changelog?api_type=shopifyql)

Starting in API version 2026-10, ShopifyQL adds Shop Campaigns fields to two schemas. The `shop_campaign_insights` schema adds a `shop_campaign_orders` metric and `country` and `country_code` dimensions. The `sales` schema adds four Shop Campaign dimensions, so you can break down sales by the campaign that drove them.

## What changed

The [`shop_campaign_insights` schema](https://shopify.dev/docs/api/shopifyql/2026-10/schemas/marketing/shop_campaign_insights) adds these fields:

| Field | Type | Description |
| - | - | - |
| `shop_campaign_orders` | Metric | Number of orders associated with Shop Campaigns. |
| `country` | Dimension | Billing country for orders associated with Shop Campaigns. |
| `country_code` | 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:

`FROM shop_campaign_insights SHOW shop_campaign_orders, shop_campaign_ad_spend GROUP BY country_code SINCE -30d`

The [`sales` schema](https://shopify.dev/docs/api/shopifyql/2026-10/schemas/sales_revenue/sales) adds these dimensions. Each one describes the Shop Campaign associated with the order:

| Field | Description |
| - | - |
| `shop_campaign_name` | Name of the Shop Campaign. |
| `shop_campaign_handle` | Merchant-facing handle of the Shop Campaign associated with the order. |
| `shop_campaign_target_name` | Name of the customer segment the campaign targeted, such as `New customers`. |
| `shop_campaign_currency_code` | Currency code for local monetary fields on the Shop Campaign order. |

These dimensions work with any `sales` metric. For example:

`FROM sales SHOW total_sales, orders GROUP BY shop_campaign_name SINCE -30d`

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:

1. Update your GraphQL Admin API requests to version 2026-10.
2. Add the fields to your ShopifyQL queries.
3. Test against a development store that has at least one Shop Campaign with orders.

## Related docs

* <https://shopify.dev/docs/api/shopifyql/2026-10/schemas/sales_revenue/sales>
* <https://shopify.dev/docs/api/shopifyql/2026-10/schemas/marketing/shop_campaign_insights>