Platform limits

While we minimize hard limits in the API, some restrictions help ensure optimal performance.

XP length

Maximum length for any xp object: 8000 characters.

Extended properties (XP) demonstrate our Flexibility Over Features approach. Follow our best practices to manage xp size effectively. If approaching the limit, consider mapping data to an external store.

Generated variants

Maximum variants per product: 1500.

Generating Variants creates unique combinations of spec options. Example:

Six specs with three options each: 729 variants (allowed)
Six specs with four options each: Exceeds limit (not allowed)

Auto apply promotions

Maximum promotions per API call: 100.

Applies to:

v1/orders/{direction}/{orderID}/applypromotions
v1/cart/applypromotions

Additional evaluations require separate API calls.

Products per collection

Maximum products per collection: 500.

This limit ensures optimal ProductCollection performance. No limit exists on the number of collections per user.

Unique extended property keys

Recommended limit: ~100 unique keys for:

Products
Orders
Line items

For orders with nested line item and product data, keys accumulate quickly. Example:

100 order keys
100 line item keys
100 product keys Total: 300 unique keys in order search documents

Exceeding recommended limits may result in flattened extended properties and limited search capabilities.

Line items per submitted order

Soft limit: A few hundred line items per order.

Factors affecting the limit:

Complex indexing processes
Line item data volume
Product data volume

The API allows exceeding this limit but may not index orders properly, affecting list operations.

Deep paging

Recommended limit: Maximum 30 pages.

Use the LastID Method for optimal performance:

Initial call:
page=1&pageSize=100&sortBy=ID
Track last item's ID
Subsequent calls:
page=1&pageSize=100&sortBy=ID&ID=>{lastID}
Stop when receiving empty Items array

If you have suggestions for improving this article, let us know!