Specifies the maximum number of GraphQL cost points that each call is allowed to consume.

Data Type

string

Default Value

"50"

Remarks

Shopify’s GraphQL API enforces a throttling system based on cost points. Each query consumes cost points, and apps operate under a shared budget that refills over time.

Use this property to cap the cost of individual GraphQL requests generated by the server. By setting a maximum, you can prevent large queries from exhausting your available quota and help avoid throttling errors.

Note: Shopify applies different rate limits based on your account type. Standard accounts are limited to 1,000 cost points with a default refill rate of 100 points per second. Shopify Plus and enterprise plans have higher refill rates, up to 2,000 points per second.

This property is useful when you're working with large datasets or multiple concurrent queries and need to manage resource usage carefully to avoid hitting Shopify's rate limits.

Lowering the point cap may reduce the risk of hitting API limits but can lead to more, smaller API calls. Higher values may improve performance by allowing more data per call, but increase the likelihood of throttling.