What does Product.PurchaseError.invalidQuantity mean?

Product.PurchaseError.invalidQuantity means the quantity you passed to purchase(options:) is not valid.

Quick facts#


Error	`Product.PurchaseError.invalidQuantity`
Where	StoreKit 2, Swift (`Product.purchase(options:)`)
Available since	iOS 15.0, iPadOS 15.0, macOS 12.0, tvOS 15.0, watchOS 8.0, visionOS 1.0
What the vendor says	The quantity to purchase is invalid.

Cause#

The .quantity(_:) purchase option sets how many items the customer buys. Apple says the quantity applies to consumable In-App Purchases and non-renewing subscriptions (PurchaseOption.quantity).
A quantity for a product of another type, or a value outside what the App Store accepts, is not a valid quantity. Apple does not publish the accepted range on the case page.
The error comes from the arguments your code passes, so it is reproducible and not a store outage.

Fix#

Remove the .quantity option unless the product is a consumable or a non-renewing subscription.
Pass a whole number of at least 1, and keep it small. Log the value you send.
Check the product's type in App Store Connect against what your code assumes.
Test the purchase in the sandbox or a StoreKit configuration file before you ship.

Example#

Swift

import StoreKit

// Quantity is for consumables and non-renewing subscriptions only; guard the value before you pass it.
func buy(_ product: Product, quantity: Int) async {
    guard quantity >= 1 else { return }
    do {
        let result = try await product.purchase(options: [.quantity(quantity)])
        print("Result: \(result)")
    } catch Product.PurchaseError.invalidQuantity {
        print("The App Store rejected quantity \(quantity) for \(product.id)")
    } catch {
        print("Purchase failed: \(error)")
    }
}

Compile-checked: npm run check:snippets type-checks this snippet with swiftc against the Apple SDK (macOS target, checked 2026-10-03).

How the RevenueDot SDK reports it#

The RevenueDot purchases-ios fork maps Product.PurchaseError.invalidQuantity to ErrorCode.storeProblemError (code 2). The SDK's own purchase API does not expose a quantity, so this error normally appears only when your code calls StoreKit directly. See what storeProblemError means.

Source#

Checked: 2026-10-03

Edit this page on GitHub ↗ View as Markdown Last updated October 3, 2026