--- title: "Shopify cart line quantity limit, verified November 2026" description: "What the Storefront API answered for a cart line of 1,000,000 units and of 1,000,001: the largest quantity a line takes, the error past it, and a message that states the limit one unit low. Verified 3 November 2026 on Shopify's 2026-10 API." url: https://offersuite.io/shopify/limits/line-quantity updated: 2026-11-03 --- # Shopify's cart line quantity limit: 1,000,000 units One Storefront API cart line takes a quantity of up to 1,000,000. Past that the cart is not created. The error message says the quantity must be less than 1,000,000, which is one unit stricter than what the store accepted. Verified 3 November 2026 on Shopify’s 2026-10 API, on a real store. Each statement marked with a tick is checked against the answer Shopify gave. ## 1,000,000 is accepted and 1,000,001 is not Both carts were one line of one product. The first came back with its quantity as sent. The second came back as no cart, with a userErrors entry that names the line's quantity. **One cart line at a quantity of 1,000,000, and at 1,000,001** Verified 3 November 2026 · API 2026-10 #### What was sent, and what Shopify answered What Shopify answered: One cart line at a quantity of 1,000,000, and at 1,000,001 | Step | Answer | Quantity of the line | | --- | --- | --- | | 1. cartCreate with one line of quantity 1,000,000 | Accepted | 1,000,000 | | 2. cartCreate with one line of quantity 1,000,001 | Refused in the mutation's userErrors `INVALID` “The quantity for merchandise with id … must be greater than zero but less than 1000000.” | no cart | #### What that shows - A line of quantity 1,000,000 was accepted, and the cart came back with that quantity. - A line of quantity 1,000,001 was refused in userErrors, with the code INVALID, naming the line's quantity as the field. No cart was created. - The message read “The quantity for merchandise with id … must be greater than zero but less than 1000000.” (the id is left out here). It says less than 1,000,000, and 1,000,000 itself was accepted: the limit is the number in the message, inclusive. ## Cap a quantity field at what the cart took, not at what the message says A quantity field capped from the message refuses an order of exactly 1,000,000 units that Shopify takes. The gap is one unit, and it only matters to a wholesale form that sets its own maximum from the error text. This run says nothing about stock. The store took the quantity for this product; a product whose inventory is tracked may be stopped by its stock first. ## How this was verified Every step on this page was sent to a Shopify Plus development store we keep for this, on API version 2026-10, and Shopify’s answer was recorded as it came back. The carts were built through the Storefront API with cartCreate, one line each, and the quantity was read from the cart that came back. No order was placed. A suite sends these steps again. A statement that no longer matches the answer takes this page down until it is corrected, and no record stands for more than 90 days without being taken again. This is what one store answered on one API version: your store’s plan can change the result, so try it on a development store. Seen something different on your store? Write to [privacy@offersuite.io](mailto:privacy@offersuite.io) with the request and the answer and we’ll run it. ## Related - [Shopify, verified **Shopify offer mechanics, verified on a real store** How Shopify discounts, discount functions, cart transforms, selling plans, the Storefront cart and their limits behave, shown in real carts built on a Shopify store and built again at least every 90 days.](https://offersuite.io/shopify) - [Feature **Serve a verified offer to your buy box** Show a verified offer through the Verified offer theme block, your developers' code on the public API, or your agent, with every price computed by the server.](https://offersuite.io/features/buy-box) - [Shopify, verified **Shopify Storefront cart discounts, verified November 2026** Where a Shopify Storefront API cart reports each kind of discount: product discounts on the line, order discounts on the cart, shipping discounts on the delivery group, and codes it did not apply in warnings. Verified 3 November 2026 on Shopify's 2026-10 API.](https://offersuite.io/shopify/storefront-cart) - [Shopify, verified **Shopify cart line limit, verified November 2026** What the Storefront API answered as a cart was built to 500 lines and past: the 250-item limit on one mutation's input, the 500-line limit on the cart, and the two different places the errors arrive. Verified 3 November 2026 on Shopify's 2026-10 API.](https://offersuite.io/shopify/limits/cart-lines) - [Shopify, verified **Shopify discount functions, verified November 2026** What a Shopify discount function's output looks like in a real Storefront cart: where the allocation lands, a line split by a partial discount, and one discount with a product and a shipping class. Verified 3 November 2026 on Shopify's 2026-10 API.](https://offersuite.io/shopify/discount-functions)