# What changed in @stripe/stripe-js

> 36 changes in @stripe/stripe-js 2 to 10 from its official release notes, upgrade guides and advisories: 13 breaking, 1 deprecations, 13 new APIs and options. Each one cited. Sources checked 2026-11-15. HTML: https://unstale.sh/npm/@stripe/stripe-js/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @stripe/stripe-js 10

### Breaking changes

- Removes defaultCollapsed from update() types because this layout option cannot be updated. (10.2.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.0)
- Removes paymentMethodLogoPosition from update() types because this layout option cannot be updated. (10.2.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.0)
- Removed Elements paymentMethodTypes from the types for Endive. (10.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.0.0)
- The loader now retries. (10.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.0.0)
- Removed the payment request button for Endive. (10.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.0.0)

### New APIs and options

- Adds public types for the pe fieldchange event, making its types available to developers. (10.3.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.3.0)
- Canary Islands NIF was added to the Checkout and Tax ID Element types. (10.2.1) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.1)
- Types were added for the Pricing SDK beta. (10.2.1) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.1)
- EwCS types add update actions for individual and business names. (10.2.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.0)
- EwCS types add nameCollection. (10.2.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.0)
- Adds new appearance variables for accordion triggers. (10.1.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.1.0)
- Adds the mobile_web client option for WeChat Pay. (10.1.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.1.0)

### Performance

- Concurrent loadStripe calls now share an in-flight Stripe.js load. (10.1.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.1.0)

### Fixes and other changes

- Adds the missing RON currency to PMME. (10.2.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.2.0)
- Added types for the BLIK setup confirmer. (10.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.0.0)
- Added missing types for confirmPayByBankPayment. (10.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v10.0.0)

## @stripe/stripe-js 9

### New APIs and options

- Adds support for pre-collected consent. (9.17.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v9.17.0)

## @stripe/stripe-js 8

### Breaking changes

- Types for the Checkout SDK were updated in a breaking change. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)
- Clover elements were removed. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)
- Optional mode parameters for stripe.elements were replaced with a discriminated union. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)
- Types for redirectToCheckout were removed in a breaking change. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)

### New APIs and options

- Types were added for Condensed Inputs. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)
- confirmAcssDebitSetup() now supports expand. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)

### Fixes and other changes

- Types were added for the metadata field. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)
- Types for PaymentMethod were fixed for all GA-ed LPMs. (8.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v8.0.0)

## @stripe/stripe-js 7

### Tooling

- Typings were added for developer tools. (7.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v7.0.0)

### Fixes and other changes

- Elements types were modified to support Checkout Session types for GA. (7.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v7.0.0)

## @stripe/stripe-js 6

### Behavior and default changes

- Acacia v6 is generally available. (6.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v6.0.0)

## @stripe/stripe-js 5

### Breaking changes

- Custom Checkout is renamed to Checkout. (5.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v5.0.0)

### New APIs and options

- Types for customPaymentMethods are added. (5.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v5.0.0)

## @stripe/stripe-js 4

### Breaking changes

- Removed as a type; replace its usage with ExpressCheckoutPaymentMethodOptionWithAlways. (4.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v4.0.0)

### Deprecations

- The wallets option is deprecated; use paymentMethods instead. (4.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v4.0.0)

### New APIs and options

- Extended to include themes for PayPal for Express Checkout Element. (4.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v4.0.0)
- Added to StripeExpressCheckoutElementOptions, extending the original wallets with link, paypal, and amazonPay. (4.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v4.0.0)

## @stripe/stripe-js 3

### Breaking changes

- Fixes ES module imports; update imports when moving to this major release. (3.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v3.0.0)

## @stripe/stripe-js 2

### Breaking changes

- The unsupported `none` theme was removed. (2.0.0) — [release notes](https://github.com/stripe/stripe-js/releases/tag/v2.0.0)
