RyzeDeskRyzeDesk

Stripe

4105 articles

Changes the Address Element state field to default to Latin-formatted characters


Breaking changes

Changes the Address Element state field to default to Latin-formatted characters Breaking changes

What’s new

Changes the state property of the Address Element to default to Latin character formatting. Previously, the getValue() method and billing or shipping address change event would return the state value in a format matching the user’s browser locale.

Why is this a breaking change?

If your code expects the Address Element state to be in a browser-localised format by default, you must update it to expect a Latin-formatted state or to explicitly request the localised format. You can only request a localised value by passing the format: localized option to getValue(). The address change event always returns a Latin-formatted state.

Impact

You can now expect the state property of the Address Element to be formatted in Latin characters unless you explicitly request a localised value. To retrieve the value localised according to the user’s browser settings, call getValue() with the format option set to localized.

If you want to retrieve the localised value from an address change event, you can call getValue({format: 'localized'}) in the event callback.

Last verified 2026-09-27

Is this helpful?