ST-2026-109 · Removals & lifecycle enforcement
Shopify deprecates cumulative marketing engagements
Shopify Admin GraphQL API 2026-07 deprecates the isCumulative argument on marketingEngagementCreate, defaults it to false, and directs integrations toward non-cumulative engagement reporting.
Previous state
Admin GraphQL API integrations could mark marketingEngagementCreate activity metrics as cumulative with the isCumulative argument, and existing activities could report cumulative engagement values.
Current state
In Admin GraphQL API version 2026-07, isCumulative is deprecated and defaults to false; Shopify directs integrations to send non-cumulative marketing engagements instead.
Affected users
Who needs to care
Apps calling marketingEngagementCreate with isCumulative set to true or whose marketing measurement pipeline depends on cumulative activity metrics.
Required response
What to do
Change engagement submissions and any upstream aggregation logic to send non-cumulative values, remove reliance on isCumulative=true, and verify downstream measurement before adopting the new behavior.
Evidence boundary
What the source does not prove
Shopify has not announced a removal version or mandatory migration date. The notice says existing activities sending cumulative metrics can migrate at any time and does not state that marketingEngagementCreate itself is being removed.
Lifecycle history
Dated event sequence
- Deprecation announced for API 2026-07
Shopify deprecated isCumulative, set its default to false and instructed integrations to send non-cumulative engagements.
Evidence ledger
First-party sources
- 01Shopify — Deprecation of cumulative marketing engagements
Official Shopify developer changelog · 2026-07-01
Open official source ↗