Just launched
We're actively working on new content and improvements to our documentation. We'd love to hear your thoughts, launch quick survey
Paddle Billing


Updates the list of items for an open checkout.

Use Paddle.Checkout.updateItems() to dynamically update the items list for an open checkout.

Typically used with inline checkout to update quantities or add addons to the checkout.

To use this method, a checkout should already be opened. Use the Paddle.Checkout.open() method to open a checkout.

Pass an array of objects, where each object contains a priceId and quantity property. priceId should be a Paddle ID of a price entity.

Recurring items on a checkout must have the same billing interval. For example, you can't have a checkout with some prices that are billed monthly and some products that are billed annually.

Paddle expects the complete list of items that you'd like to be on the checkout — including existing items. If you don't include an existing item, it's removed from the checkout. See: Work with lists

Make sure there's always one item included on the checkout. You'll get an error if you try to update the checkout so it has no items.



List of items for this checkout.

priceIdstring<Paddle ID>

Paddle ID of the price for this item.


Quantity for this line item.


This example passes an array called itemsList to Paddle.Checkout.updateItems().

If successful, the items on the opened checkout are updated.


checkout.items.updatedEmitted when the checkout items list is updated.
checkout.items.removedEmitted when an item is removed from the checkout.

Related pages