GraphQL query length limit and pagination behavior in Vue Storefront

Confirmed Behavior

Vue Storefront 2.x enforces a 1000-character limit on GraphQL queries through Apollo Server middleware. This limit is applied uniformly across both Community and Enterprise editions, returning HTTP 400 with a QUERY_TOO_LONG error type when exceeded.

Edition Differences

The core enforcement mechanism is identical between editions. The distinction lies in logging format: Community Edition outputs plain console messages like GraphQL Error: Query must be non-empty and <= 1000 characters, while Enterprise includes structured JSON logging with metadata fields. Both reference the same validation rule and character threshold.

HTTP Response Consistency

Exceeding the limit consistently returns HTTP 400 status code with a GraphQL error response. The response body contains an errors array with an error object having extensions.errorType set to QUERY_TOO_LONG. This behavior is standard across deployment methods—whether running via Docker, Node.js directly, or as part of a larger service.

Pagination Strategy Within Limit

Cursor-based pagination (first/after) produces shorter queries than offset-based approaches. Structure pagination queries to:

1. Use only required fields—avoid requesting full product objects when thumbnails suffice
2. Define fragments for repeated field sets to reduce query size
3. Limit page size to 20-50 items; larger sizes with complex nested fields will exceed 1000 characters
4. Apply filtering at the field level rather than retrieving all data then filtering client-side

Verification Steps

To confirm your deployment's behavior:

# Test limit enforcement
curl -X POST http://localhost:8080/graphql \
  -H 'Content-Type: application/json' \
  -d '{"query":"{ products(first:1000){ edges{ node{ id name description longDescription ... on Product { prices { price { currency amount } } } } } } } }"}'

# Check environment configuration
docker exec <container_id> env | grep -i query

Configuration Override

Docker image tags may allow overriding the limit through environment variables. Check for GRAPHQL_QUERY_LENGTH_LIMIT or VSF_CONFIG.graphql.queryLengthLimit in your container environment. Version 3.x introduces additional configuration paths through VSF_CONFIG environment object.

One diagnostic detail needed: What Vue Storefront version and deployment method are you using? This determines whether the 1000-character default applies or if version 3.x configuration patterns are relevant.