Adds the ability to update line items on existing Checkout Sessions with a custom UI
What’s new
You can now update line items when using Elements with Checkout Sessions. Additionally, you can now create and update line item metadata.
Impact
You can now modify session details after creating a session. This change enables more dynamic checkout flows, such as updating a shopping cart, changing promotional pricing, or adding custom tracking information through metadata.
When you update a Checkout Session with a custom UI mode you can now:
- Update line item price , quantity , and tax_rates
- Add and modify metadata on the session
- Use price_data to create prices inline
- Enable adjustable_quantity to let customers modify quantities during checkout
See the related guide for more examples.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| metadata | Added | Checkout. Session#create. line_items[] LineItem Checkout. Session#update |
Upgrade
- View your current API version in Workbench.
- If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-12-15. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.