Skip to content
Create account
 or
Sign in
The Stripe Docs logo
/
Create account
Sign in
OverviewUpgrade your integration
Online payments
OverviewFind your use case
Payment methods
Payment UIs
Payment scenarios
In-person payments
Other Stripe products

Update line itemsBeta

Make changes to the line items during checkout.

A Checkout Session’s line items keep track of what your customer is purchasing. You can configure the Checkout Session so customers can adjust line item quantities during checkout.

Other line item updates, such as adding new line items, are not yet supported.

Enable adjustable quantities
Server-side

Set adjustable_quantity on your line_items when creating a Checkout Session to enable your customers to update the quantity of an item during checkout.

server.ts
const session = await stripe.checkout.sessions.create({
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'T-shirt',
        },
        unit_amount: 2000,
      },
      quantity: 1,
      adjustable_quantity: {
        enabled: true,
        maximum: 100,
        minimum: 0,
      },
    },
  ],
  mode: 'payment',
  ui_mode: 'custom',
  return_url: '{{RETURN_URL}}'
});

You can customize the default settings for the minimum and maximum quantities allowed by setting adjustable_quantity.minimum and adjustable_quantity.maximum. By default, an item’s minimum adjustable quantity is 0 and the maximum adjustable quantity is 99. You can specify a value of up to 999999 for adjustable_quantity.maximum.

Checkout prevents the customer from removing an item if it is the only item remaining.

Update line item quantities
Client-side

Use updateLineItemQuantity to change a line item’s quantity in response to customer interaction, such as a button to increment the quantity:

IncrementLineItemButton.jsx
import React from 'react';
import {useCheckout} from '@stripe/react-stripe-js';

const IncrementLineItemButton = (props) => {
  const {updateLineItemQuantity} = useCheckout();

  const handleClick = () => {
    updateLineItemQuantity({
      lineItem: props.lineItem,
      quantity: props.quantity + 1,
    });
  };
  return <button onClick={handleClick}>+</button>;
};

export default IncrementLineItemButton;
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc