API default/result semantics
Shopify GraphQL count 10000 count precision cap
Analytics shows exactly 10,000 for a store with more records and no API error.
Agent Quick Fix
Repair against the current Shopify GraphQL counts contract, then keep the change narrow and source-backed.
Product: Shopify GraphQL counts
Current-contract area: Shopify count query silently caps at 10,000
Likely root cause: Analytics shows exactly 10,000 for a store with more records and no API error.
Repair direction: Verifier checks complete results or an intentional cap with correct pagination. Check both uncapped and intentionally capped use cases.Symptom
Analytics shows exactly 10,000 for a store with more records and no API error.
Why This Happens
The query shape remains valid but server defaults change completeness or meaning; local tests with small data sets cannot reveal truncation.
Common Wrong Fixes
- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.
Codex Search Keywords
These are the search terms observed in a neutral Codex validation run for this failure shape.
site:shopify.dev GraphQL count capped at 10000 Shopify count precision
Shopify GraphQL count 10000 count precision cap
Shopify Admin GraphQL Count precision AT_LEAST 10000
site:shopify.dev/docs/api/admin-graphql Count precision
https://shopify.dev/docs/api/admin-graphql/latest/objects/Count
'AT_LEAST' in https://shopify.dev/docs/api/admin-graphql/latest/objects/Count