Every piece of text in @dynamic-labs-sdk/react-ui has an English default that you can replace, such as to match your product’s voice or to translate the widgets. This page lists every text key, grouped by the screen where it appears.
How to replace text
Pass a text dictionary to DynamicUiProvider. The first level is the slot, which names the component, and the second level is the key, which names one piece of text in it:
Keep these rules in mind:
- Set only what you change. A key you leave out keeps its default.
- Slots and keys are checked. The dictionary is typed, so a misspelled slot or key is a TypeScript error rather than text that silently stays on its default.
- Placeholders are optional. A key whose default contains a placeholder, such as
{wallet}, replaces it when the widget renders. Your text can use that placeholder or leave it out. A key only fills the placeholders listed for it, and any other text in braces is shown as written.
- Shared components change everywhere. Components such as the panel header and the search field appear in several widgets, so a key in their slot applies to all of them. To change text in one place only, wrap that part of your app in
TextProvider, which takes the same text dictionary. Nested dictionaries merge, and the innermost value wins.
- Some text is for screen readers only. Keys described as screen reader text, such as
announcement, are not visible but are read aloud by assistive technology. Translate them with the rest of the text.
The tables show each default exactly as the component renders it, including its punctuation.
Wallet connection
Text in the connect wallet widget. The Flow payment widget uses the same screens when the payer connects a wallet.
Screen titles and status messages of the connect wallet widget.
dyn-wallet-list
The searchable list of wallets.
dyn-wallet-chain-list
The chain choice, shown when a wallet supports more than one chain.
dyn-wallet-connect-qr-code
The QR code screen for wallets that connect by pairing, such as through WalletConnect.
Flow payment: loading
Shown while the Flow payment widget loads the payment, and when it cannot.
dyn-flow-loading-view
The loader shown while the payment loads.
dyn-flow-load-error
The screen shown when the payment cannot load or no payment matches the link.
Flow payment: payment method
dyn-flow-choose-payment-source-view
The payment method choice: wallet, exchange, or deposit address.
Flow payment: wallet
Screens of a wallet payment, in FlowWidget and FlowPayWithWalletWidget.
dyn-flow-wallet-connection-view
The wallet connection step of a payment.
dyn-flow-wallet-attach-error-banner
Errors shown when the connected wallet cannot be used for the payment.
dyn-flow-choose-token-view
The token choice.
dyn-flow-review-payment-view
The payment review, with the quote, the terms consent, and the confirm button.
dyn-flow-swap-tile
The tiles showing what the payer pays with and what is received.
dyn-flow-payment-swap-tile
Fallbacks inside the swap tiles when token details are missing.
dyn-flow-payment-not-approved
The screen shown when the payer declines the transaction in their wallet.
Flow payment: exchange
Screens of an exchange payment, in FlowWidget and FlowPayWithExchangeWidget. Most keys accept {exchange}, which the widget replaces with the exchange’s name.
dyn-flow-choose-exchange-view
The exchange choice.
dyn-flow-exchange-view
The screen that opens the exchange and waits for the purchase.
dyn-flow-leave-exchange-view
The confirmation shown when the payer goes back after opening the exchange.
Flow payment: deposit address
Screens of a deposit-address payment, in FlowWidget and FlowDepositAddressWidget.
dyn-flow-deposit-address-view
The network and token choice, the address, and the exact amount to send.
dyn-flow-refund-address-sheet
The sheet that asks the payer for a refund address.
dyn-flow-leave-deposit-address-view
The confirmation shown when the payer goes back after receiving an address.
Flow payment: processing
dyn-flow-processing-payment
The progress screen shown after the funds are sent.
dyn-flow-payment-step-tracker
Screen reader text for the progress steps.
Flow payment: outcomes
dyn-flow-payment-complete
The screen shown when the payment completes.
dyn-flow-already-paid
The screen shown when the payment was already completed before the widget opened.
dyn-flow-payment-failed
The screen shown when the payment fails.
dyn-flow-payment-refunded
The screen shown when the payer sent the wrong amount to a deposit address and the payment is refunded.
dyn-flow-payment-cancelled
The screen shown when the payment was cancelled.
dyn-flow-expired
The screen shown when the payment expired.
Shared components
These components appear inside several widgets, so a change here applies everywhere the component appears. To change one place only, wrap that widget in its own TextProvider.
The header at the top of every widget screen.
dyn-search-bar
The search field in lists.
dyn-select
The dropdowns, such as the network and token choice for a deposit address.
The copy button on the QR code screen.
dyn-copy-field
The copyable fields, such as the deposit address.
dyn-copy-text
The copyable values, such as the amount to send and the payment reference.
dyn-qr-code
Every QR code.
dyn-provider-list
The generic provider list, used for exchanges.
dyn-wallet-account-balances
The WalletAccountBalances view.
dyn-balances-list
The token balance list inside WalletAccountBalances.
Last modified on November 5, 2026