Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Versioning
Changelog
    Overview
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Developer tools
SDKs
API
Testing
Workbench
Event Destinations
Workflows
Stripe CLI
Stripe Shell
Developers Dashboard
Agent toolkit
Stripe health alertsBuilding with LLMsStripe for Visual Studio CodeFile uploads
Security
Security
Extend Stripe
Stripe Apps
Stripe Connectors
Partners
Partner ecosystem
Partner certification
HomeDeveloper toolsChangelogBasil2025-03-31.basil

Updates the default layout for Payment ElementBreaking changes

What’s new

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.

Why is this a breaking change?

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.

If your defaultCollapsed value is undefined and you want to restore the previous behavior, you can set the value to true.

Impact

Using an accordion layout and collapsing multiple payment methods can help improve conversion rates for mobile users.

Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc