Localization

Customize the language and currency displayed on checkout

Translate the checkout to the user's language and allow them to pay in their local currency.

The default checkout is in English and USD. Crossmint will automatically detect the location of the buyer and adjust language and currency accordingly, unless otherwise specified by you.

Currencies and Languages Available

Variable	Possible Values	Description
locale	en-US de-DE es-ES fr-FR it-IT ja-JP ko-KR pt-PT ru-RU th-TH tr-TR uk-UA vi-VN zh-CN zh-TW Klingon	Language displayed to the user in the checkout interface
payment.fiat.defaultCurrency	usd aud eur gbp hkd inr jpy krw sgd vnd	Default fiat currency for payments in the checkout interface (default: USD)

How to Adjust the Currency and Language

To customize the language use the property locale and for currency, set defaultCurrency. Here’s an example:

<CrossmintProvider apiKey="_YOUR_CLIENT_API_KEY_">
    <CrossmintEmbeddedCheckout
        locale="es-ES" // Change locale to Spanish
        lineItems={{
            collectionLocator: "crossmint:_YOUR_COLLECTION_ID_",
            callData: {
                // your callData args
            },
        }}
        payment={{
            crypto: {
                enabled: true,
            },
            fiat: {
                enabled: true,
                defaultCurrency: "eur", // Change default currency to be Euro
            },
        }}
    />
</CrossmintProvider>