Events subscription query complexity limit is changing to 100 points
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on September 22, 2026.
This Shopify update is categorized as Action Required, API, Breaking API Change, Events & webhooks.
What changed
We’re reducing the query complexity limit for Events subscriptions from 250 to 100 points. This change does not affect Classic Webhooks. Shopify assigns each Events query a complexity score based on the fields it selects, the types of data those fields return, and the number of items requested in connections using first or last, following the GraphQL query cost calculation. The limit applies to each subscription query, and queries executed by Events subscriptions don’t count toward your app’s API rate limits.
Who is affected
Apps that subscribe to or process Shopify webhooks or event payloads should review this change.
What action may be needed
Review subscription queries that exceed 100 points and shape each subscription around the changes your app handles: Split subscriptions by the work they do: You can configure multiple subscriptions for the same topic, each with its own triggers and query. Query the changed resource directly: For example, for a variant price change, query the affected variant’s price, SKU, and parent Product ID instead of fetching the Product’s first 250 variants.
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 →