How to Add Multiwallet Linking to Your Crypto App
Most onchain apps are built around a single assumption: one user, one wallet. For casual users, that assumption holds. For the power users who drive the majority of volume on trading and staking platforms, it doesn't.
A serious DeFi user might hold their long-term staking positions in a hardware wallet, their active trading capital in MetaMask, and a smaller allocation in a mobile wallet for quick access. When your app only lets them connect one, you're asking them to make a choice. This means either missing out on potential transaction volume or splitting their activity across multiple platforms.
Multiwallet linking removes that constraint. Users connect all the wallets they want to use, switch between them within a session, and interact with your platform using whichever wallet makes sense for each action.
This guide covers why it matters, who should build it, and how to integrate it using the Reown SDK.
Why Add Multiwallet Linking to Your App?
To offer a unified user experience for both power users and new users
Sophisticated DeFi users don't consolidate their assets in a single wallet. And for good reason; using hardware wallets for cold storage, hot wallets for active trading, separate wallets for different chain ecosystems is a good security practice. For that reason, forcing a single-wallet session is a UX constraint that most power-users have to grapple with more than they’d like. If your app supports multiwallet sessions, you can offer an improved user experience for power-users and new users alike.
More available liquidity per user
In trading and staking contexts, liquidity fragmentation across wallets directly limits what a user can do in your app. A trader with $10K in one wallet and $10K in another is a $20K user on a platform that supports multiwallet linking. Conversely, that same user acts as two $10K users split across competing platforms if you don't. Multiwallet Linking eliminates the fragmented liquidity issue.
Better behavioral data
When a user has to create separate sessions for each wallet, your analytics see two users instead of one. Multiwallet linking consolidates that activity into a single user record. This gives you accurate retention data, a clearer picture of per-user value, and behavioral signals you can act on. Reown's analytics layer reflects this consolidation automatically.
Wallet comparison and portfolio views
For apps that serve users managing multiple positions, such as yield platforms, portfolio trackers, multi-strategy staking apps di;splaying balances and positions across connected wallets is a feature users actively want. Multiwallet linking makes this view possible without requiring users to reconnect between screens.
Who Should Add Multiwallet Linking to Their Apps?
Trading platforms
Active traders frequently separate their capital by strategy or risk profile across wallets. If you let users connect multiple wallets, they can choose the appropriate wallet for each transaction. This offers a better experience and hands agency back to your users.
Staking and yield platforms
Staking positions are often distributed across wallets for security and custody reasons: a hardware wallet for long-term positions, a hot wallet for positions the user manages actively. Multiwallet linking lets staking platforms display and manage all of a user's positions in one view.
DeFi portfolio dashboards
Of course, Portfolio management apps are the clearest use case for multiwallet linking. Their entire goal is a consolidated view across all of a user's assets, and multiwallet linking makes that possible immediately.
Any platform with high-value or power users
If your user base skews toward experienced DeFi users, such as traders, yield farmers and liquidity providers, multiwallet linking is worth prioritising. These users know the feature exists on competing platforms, and they'll choose platforms that support it when the alternative is an inferior workflow.
How Does Multiwallet Linking Work?
Reown's multiwallet linking is enabled via the Reown SDK and managed through the dashboard. Under the hood, it allows your app to maintain multiple active wallet connection states simultaneously — each wallet independently connected and authenticated, with the ability to designate an active wallet for a given action.
The SDK exposes two primary hooks for managing multi-wallet state:
- useAppKitConnection — accesses the currently active wallet connection, including its address, chain, and connection status
- useAppKitConnections — accesses the full list of connected wallets, their addresses, and their states
These hooks give you the data to build: wallet switchers, multi-wallet dashboards, per-wallet balance views, and connection management interfaces.
To learn more about the technical workings, visit the multiwallet linking docs.
What to Consider When Adding Multiwallet Linking
Make sure your user knows which wallet is active
When multiple wallets are connected, it must always be clear to the user which wallet is active. Ambiguity can potentially pose a serious UX issue, especially on a trading or staking platform where a transaction is about to move funds. With Reown’s components, making this switch simple and aesthetically pleasing is simple.
Session management
Each connected wallet maintains its own session state. Think through how your app handles scenarios where one wallet disconnects mid-session, or where a user connects a wallet but then switches chain in another connected wallet. Your state management logic should handle this as gracefully as possible.
Analytics
With multiwallet linking active, your analytics should treat activity from all connected wallets as belonging to a single user. Reown's analytics layer handles this automatically, but if you're building custom analytics or piping data into a third-party tool, verify that your implementation consolidates correctly.
Before You Add Multiwallet Linking
Upgrade to Pro or Enterprise
Multiwallet linking requires a paid plan. If you're on Starter, upgrade via the Reown dashboard before proceeding. Pro starts at $89/month.
Install the Reown SDK
If you haven't already integrated the Reown SDK:
npm install @reown/appkit @reown/appkit-adapter-wagmi wagmi viemCheck that your framework supports Multiwallet Linking
Multiwallet linking is currently compatible with React, Vue and Next.js.
Enable multiwallet linking in the dashboard
Log in to dashboard.reown.com, navigate to your project settings, and enable multiwallet linking. Once enabled, the feature is available in your SDK implementation.
How to Integrate Multiwallet Linking: A Step-by-Step Guide
Step 1: Initialise the Reown SDK with your configuration
Set up the SDK with your Project ID and target networks:
import { createAppKit } from '@reown/appkit'
import { WagmiAdapter } from '@reown/appkit-adapter-wagmi'
import { mainnet, arbitrum, base } from '@reown/appkit/networks'
const wagmiAdapter = new WagmiAdapter({
projectId: 'YOUR_PROJECT_ID',
networks: [mainnet, arbitrum, base]
})
createAppKit({
adapters: [wagmiAdapter],
projectId: 'YOUR_PROJECT_ID',
networks: [mainnet, arbitrum, base]
})Step 2: Access the active connection
Use useAppKitConnection to read the currently active wallet in any component:
import { useAppKitConnection } from '@reown/appkit/react'
function ActiveWalletDisplay() {
const { address, chainId, isConnected } = useAppKitConnection()
if (!isConnected) return <ConnectButton />
return (
<div>
<p>Active wallet: {address}</p>
<p>Chain: {chainId}</p>
</div>
)
}Step 3: Access all connected wallets
Use useAppKitConnections to list all wallets the user has connected in the current session:
import { useAppKitConnections } from '@reown/appkit/react'
function WalletList() {
const { connections } = useAppKitConnections()
return (
<ul>
{connections.map((connection) => (
<li key={connection.address}>
{connection.address} — {connection.chainId}
</li>
))}
</ul>
)
}Step 4: Build your wallet switcher
Give users clear control over which wallet is active. A wallet switcher component should display all connected wallets with their current chain and balance, and let the user designate which one is active before any transaction:
import { useAppKitConnections, useAppKitConnection } from '@reown/appkit/react'
function WalletSwitcher() {
const { connections, setActiveConnection } = useAppKitConnections()
const { address: activeAddress } = useAppKitConnection()
return (
<div>
{connections.map((conn) => (
<button
key={conn.address}
onClick={() => setActiveConnection(conn)}
style={{ fontWeight: conn.address === activeAddress ? 'bold' : 'normal' }}
>
{conn.address.slice(0, 6)}...{conn.address.slice(-4)}
{conn.address === activeAddress && ' (active)'}
</button>
))}
</div>
)
}Step 5: Handle connection state changes
Use callbacks to respond to wallet connections, disconnections, and active wallet changes in your app state:
import { useAppKitEvents } from '@reown/appkit/react'
useAppKitEvents((event) => {
if (event.type === 'CONNECT_SUCCESS') {
// new wallet connected — update your UI state
}
if (event.type === 'DISCONNECT_SUCCESS') {
// wallet disconnected — clean up session state
}
})Step 6: Test across wallet combinations
Test your multiwallet implementation with representative combinations: two browser extension wallets, a mobile wallet alongside a desktop wallet, and a hardware wallet alongside a hot wallet. Pay particular attention to your transaction confirmation screens and verify that the active wallet is always clearly indicated.
Why Reown Is the Best Solution for Multiwallet Linking
500+ wallets supported out of the box
Reown's SDK connects to over 500 wallets via the WalletConnect network including MetaMask, Rabby, OKX, Trust Wallet, Ledger, and more. You don't need to build individual wallet adapters. Every wallet your users prefer is already supported.
Works across EVM, Solana, Ton & Tron
Multiwallet sessions works across multiple chains supported by Reown, meaning a user can have an EVM wallet, a Solana wallet and other chain’s wallets connected simultaneously. As DeFi becomes increasingly multichain, this cross-chain session support is a meaningful advantage over single-chain implementations.
Integrated analytics
When users link multiple wallets, Reown's analytics layer consolidates their activity into a single user record automatically. You get accurate per-user retention and behavioral data without custom instrumentation. At Enterprise tier, this extends to net worth segmentation and wallet intelligence. This is particularly useful for understanding the high-value users who are most likely to use multiwallet linking in the first place.
Available on a self-serve pricing tier
Multiwallet linking is available starting at Pro ($89/month). Teams can upgrade their plan in the Reown dashboard and start using multiwallet linking immediately, without having to speak to a single member of the Reown team.
Add Multiwallet Linking and Stop Competing for Fragmented Users
Power users are already managing multiple wallets. The question is whether your app accommodates that reality or forces them to fragment their activity elsewhere.
With Reown's multiwallet linking, you can ship this capability in a single afternoon and start giving your highest-value users the experience they actually need.
Ready to enable multiple wallets in your app?
Learn more about multiwallet linking in the docs and get started via the Reown Dashboard today.