Skip to content

supported-platforms.md

Latest commit

 

History

History
98 lines (79 loc) · 6.24 KB

supported-platforms.md

File metadata and controls

98 lines (79 loc) · 6.24 KB
Raw
title MetaMask Connect Supported Platforms and Connection Methods
sidebar_label Supported platforms
description View supported platforms, browsers, and connection methods for MetaMask Connect, including desktop extensions, mobile QR codes, and native deeplinks.
keywords
connect
sdk
platform
desktop
mobile
deeplink
qr code
react
react native
node
wagmi
wallet standard
solana
evm
multichain
browser extension
mobile browser
native app
connection methods
QR code connection
wallet deeplink
cross-platform wallet

Supported platforms

MetaMask Connect works across multiple environments, ecosystems, and devices. This page covers how MetaMask Connect routes connections depending on where your dapp runs, and which development environments and blockchain ecosystems are supported.

Connection methods

MetaMask Connect detects the user's environment and selects the best connection method automatically:

  • Desktop web: Connects directly to the MetaMask browser extension when available. If the extension isn't installed, a QR code is displayed so users can scan it with the MetaMask mobile app.
  • Mobile browser and native apps: Generates a deeplink that opens the MetaMask mobile app directly, keeping the experience seamless on mobile devices.
  • Node.js: Renders a QR code in the terminal for users to scan with the MetaMask mobile app, enabling wallet interactions from CLI tools and server-side scripts.

Here's how each connection method compares across dapp locations:

Dapp location User wallet Connection method MetaMask Connect Other SDKs
Desktop web browser 🧩 Browser extension Direct connection via extension ✅ Supported ✅ Supported
Desktop web browser 📱 Mobile app QR code scan ✅ Supported ⚠️ Limited*
Mobile browser 📱 Mobile app Deeplink ✅ Supported ⚠️ Limited*
MetaMask in-app browser 📱 Mobile app Deeplink ✅ Supported** ⚠️ Limited*
Native mobile app 📱 Mobile app Deeplink ✅ Supported ⚠️ Limited*
Node.js 📱 Mobile app QR code in terminal ✅ Supported ⚠️ Limited*

*Limited: Most other SDKs don't include built-in QR code or deeplink support for connecting to the MetaMask mobile app, and require additional configuration or third-party relay services.

**MetaMask in-app browser: Dapps can use the https://link.metamask.io/dapp/{url} deeplink to open directly inside the MetaMask mobile app's built-in browser, giving full wallet access without relay overhead. This works for any dapp regardless of ecosystem (EVM, Solana, or multichain).

:::caution Third-party in-app browsers WebViews inside apps like Twitter, Discord, or Reddit have inconsistent deeplink support. Some block external deeplinks or handle them incorrectly. Test in your target environments, or guide users to open your dapp in a full mobile browser. :::

:::tip For relay-based connections (QR code and deeplink), use a reliable RPC provider instead of public nodes. Relay connections are more sensitive to network latency, so services like Infura provide better reliability and performance. :::

Supported environments

The following table shows which environment and ecosystem combinations MetaMask Connect supports. Select a ✅ to jump to the relevant quickstart or guide.

Environment EVM Solana Multichain
Browser (vanilla JS/TS) ✅ ✅ ✅
React ✅ ✅ ✅
React Native ✅ ✅ ✅
wagmi ✅ — —
Wallet Standard — ✅ —
Node.js ✅ — ✅

:::note Node.js support uses QR code connections via the MetaMask mobile app. See the Node.js playground for a working example. :::

Next steps