Skip to main content
This guide assumes:
  • You are using @solana/wallet-adapter-react
  • The user is browsing on an Android Web environment, where MWA is usually the only available wallet.

Call connect() directly

You should explicitly handle two scenarios:
  1. If MWA is already selected, you should always directly call connect.
  2. If it is not selected, but available, select it as early as possible in your UI flow.
This will also fix connection related issues with Mobile Wallet Adapter.

Example: Connect Button

Connect and Sign in a single user action

If your app uses MWA and requires a user to Sign-in-with-Solana (e.gconnect + signMessage), it needs to invoke both methods from a single user action.

Why?

If signMessage is invoked programmatically (e.g in a useEffect), Android Chrome browser will block the navigation attempt in accordance with it’s trusted event policy.

Solution

To connect + signMessage in a single user action, you should directly call the signIn() method Mobile Wallet Adapter always supports the signIn method which invokes a connect and signMessage all within a single method.

Example: Sign In Button

Change the displayed name

Throughout your UI, use the text Use Installed Wallet as the displayed name for the MWA option. This descriptive text helps your users understand that this option will allow them to connect to an installed mobile wallet app (via MWA).

Example: Wallet List Item Component

Last modified on July 21, 2026