Skip to main content

Recommended: JavaScript SDK with React Hooks

For new React apps, we recommend the JavaScript SDK with React Hooks (@dynamic-labs-sdk/react-hooks) instead of the legacy React SDK documented here. The JS SDK comes with many benefits such as a much smaller bundle size and other optimizations. Use the React quickstart (JavaScript SDK) to get started.

Summary

This callback will be called when a wallet tab is selected by the user. See here how to enable wallet tabs: here.

Usage

As an event prop:
<DynamicContextProvider
  settings={{
    events: {
      onWalletTabSelected: (args) => {
        console.log('onWalletTabSelected was called', args);
      }
    }
  }}
>
 {/* ... rest of your app ... */}
</DynamicContextProvider>
As a hook:
useDynamicEvent('walletTabSelected', (args) => {
  console.log('walletTabSelected was called', args);
});

Callback Argument Value

{
  index: number;
  tab: {
    label: {
      text?: string;
      icon?: string | ReactElement;
      key?: string;
    };
    walletsFilter?: WalletsFilter;
    recommendedWallets?: RecommendedWallet[];
  }
}
The tab object contains exact properties that were provided in tabs.items — see here. Use the key property to identify each tab in this event.
Last modified on June 25, 2026