Updates the default layout for Payment Element
The default layout for the Payment Element now displays as an accordion instead of as tabs. We also updated the behavior of leaving the defaultCollapsed value undefined, which now collapses when multiple payment methods are displayed. This breaking change affects you if your integration uses the default value, and was designed to rely on a tabs layout instead of an accordion layout. To migrate, either set the layout value to tabs or change your design to match the accordion layout.
docs.stripe.comquote checked
- behaviour change
- Your codeby hand
Nemotron fixes
In its own wordsmatches the page ✓
| [Updates the default layout for Payment Element](https://docs.stripe.com/changelog/basil/2025-03-31/default-layout-of-payment-element.md) | Elements | Breaking | stripejs |
Also readmatches the page ✓
This breaking change affects you if your integration uses the default value, and was designed to rely on a `tabs` layout instead of an `accordion` layout. To migrate, either set the layout value to `tabs` or change your design to match the `accordion` layout.
- Using an accordion layout and collapsing multiple payment methods can help improve conversion rates for mobile users.
What Teire looks for in your code
nothing to search for: checked by hand
Does it reach your code?