API default/result semantics

Shopify GraphQL count limit null uncapped count default 10000

A reconciliation job undercounts large shops only.

Shopify GraphQL countsCommerce SaaS APIAPI default/result semanticsshopify_counts

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: Migration to uncapped count requires explicit limit:null
Likely root cause: A reconciliation job undercounts large shops only.
Repair direction: Verifier checks complete results or an intentional cap with correct pagination. Check both uncapped and intentionally capped use cases.

Symptom

A reconciliation job undercounts large shops only.

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.

Shopify GraphQL count limit null uncapped count default 10000
Shopify Admin GraphQL Count limit null
https://shopify.dev/docs/api/admin-graphql/latest/queries/productsCount
Shopify GraphQL counts Count object precision 10000 default limit null migration

Source Trail