Localization | Crossmint Docs

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)

Only usd is supported for credit and debit card checkouts, so set payment.currency to usd
Localization is not supported for stablecoins. While payment.crypto.defaultCurrency can be set to usdc or other supported tokens, localized stablecoins like eurc are not available

Adjust the Language and Currency

Embedded & Hosted
Headless

Use the locale property for the checkout language and payment.fiat.defaultCurrency for the payment currency:

<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 Euro
            },
        }}
    />
</CrossmintProvider>

Pass locale on the order — it sets the language of the buyer’s email receipt. Only usd is supported for card payments:

{
    "locale": "es-ES", // Language for the receipt
    "payment": {
        "receiptEmail": "jsmith@example.com",
        "method": "card",
        "currency": "usd" // If the collection is priced in another currency, the quote is returned in USD
    },
    "lineItems": [
        {
            "collectionLocator": "crossmint:_YOUR_COLLECTION_ID_",
            "callData": {
                "totalPrice": "<string>"
            }
        }
    ]
}

In a headless checkout, locale only affects the email receipt — localize the checkout interface in your own UI.

Next Steps

Appearance

Match the checkout to your brand

Receipt Customization

Customize the post-purchase receipt