onWalletTabSelected

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

onWalletConnectionFailed

⌘I

Implementation Guides

SDK Reference

onWalletTabSelected

Recommended: JavaScript SDK with React Hooks

Summary

Usage

Callback Argument Value

Recommended: JavaScript SDK with React Hooks

​Summary

​Usage

​Callback Argument Value

Summary

Usage

Callback Argument Value