Skip to main content
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.

dyn-connect-wallet-option-widget

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.

dyn-panel-header

The header at the top of every widget screen. The search field in lists.

dyn-select

The dropdowns, such as the network and token choice for a deposit address.

dyn-copy-button

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