Skip to main content
This is the recommended library for MWA on web and this guide explains why and how to migrate your web app.

​
How to upgrade

​
1. Install Mobile Wallet Standard

Installing the standard wallet takes two steps:
1
Add the library @solana-mobile/wallet-standard-mobile.
npm install @solana-mobile/wallet-standard-mobile
2
Call the registerMwa function.
CAUTIONEnsure registerMwa is invoked in a non-SSR context. if you’re using a framework with Server Side Rendering (e.g Next.js),
// 'use client' - If using Next.js, ensure it is registered in a non-SSR context.

import { 
    createDefaultAuthorizationCache, 
    createDefaultChainSelector, 
    createDefaultWalletNotFoundHandler,
    registerMwa, 
} from '@solana-mobile/wallet-standard-mobile';

registerMwa({
    appIdentity: {
      name: 'My app',
      uri: 'https://myapp.io',
      icon: 'relative/path/to/icon.png', // resolves to https://myapp.io/relative/path/to/icon.png
    },    
    authorizationCache: createDefaultAuthorizationCache(),
    chains: ['solana:devnet', 'solana:mainnet'],
    chainSelector: createDefaultChainSelector(),
    onWalletNotFound: createDefaultWalletNotFoundHandler(),
})
Now, Mobile Wallet Adapter will appear as a wallet option.
For more context, view the full installation guide.

​
2. Update to wallet-adapter >= 0.15.36

If your web app is using @solana/wallet-adapter-react update to a version >= 0.15.36. Updating fixes common MWA Web issues like:

​
Why switch?

There are several reasons to upgrade to using MWA via Wallet Standard.

​
Wallet Adapter no longer includes MWA as a default

The @solana/wallet-adapter-react library will not include MWA as a default option starting from versions >= 1.0.0. This means any web app using @solana/wallet-adapter-react will no longer display Mobile Wallet Adapter as an option for users browsing on Android Chrome, unless explicitly added.

​
Bug fixes and stability

The @solana-mobile/wallet-standard-mobile is the recommended web library for MWA going forward. This means it will receive all the latest feature additions and updates. The legacy @solana-mobile/wallet-adapter-mobile library will be deprecated and enter maintenance mode, and only receive updates for bug fixes.
Last modified on February 13, 2026