How to connect to a dapp

Does this article need to be translated?

Contribute to the Help Center

Submit translations, corrections, and suggestions on GitHub, or reach out on our Community forums.

A dapp can connect to MetaMask in two ways. The most common method is by clicking a 'Connect' (or similar) button, which prompts MetaMask to connect to the dapp. If this option is unavailable or does not work, you can also connect manually.

Automatically connect to a dapp

The most typical (and easiest) way to connect to a dapp is to let the dapp prompt you to connect with MetaMask.

Extension

1. Oftentimes, dapps will have a ‘Connect’ button—or something with similar wording—allowing you to connect your MetaMask with that dapp. Click "Connect" and select MetaMask as the wallet when prompted.

2. You will notice a prompt in MetaMask asking if you would like to connect MetaMask to the dapp. This prompt will display the accounts and networks that the dapp is requesting to connect to. By clicking the 'Edit' button next to any of these, you can fine-tune the selected accounts and networks.

3. Clicking 'Edit' next to the first section provides an overview of the accounts the dapp would like to connect to. The dapp will be able to see the addresses of the selected accounts and can suggest transactions for those specific accounts (e.g., a swap or trade if you have initiated one). You will still have to manually approve these transactions, of course.

4. Clicking 'Edit' next to the the second section will show you which networks the dapp is requesting access to. A dapp that uses multiple networks will be able to seamlessly switch between the enabled networks without needing to prompt you to switch manually.

5. If everything looks good, click ‘Connect’ to connect the selected accounts and networks with the dapp. You’re now set!

In the future, if the dapp wishes to connect to another account or network for which you have not yet granted permission, it can prompt you to grant these additional permissions. You can modify the granted permissions for the selected accounts and networks anytime.

Mobile

1. Oftentimes, dapps will have a ‘Connect’ button—or something with similar wording—allowing you to connect your MetaMask with that dapp.

2. You will notice a prompt in MetaMask asking if you would like to connect MetaMask to the dapp. This prompt will display the accounts and networks that the dapp is requesting to connect to. By tapping the 'Edit' button next to any of these, you can fine-tune the selected accounts and networks.

3. Tapping 'Edit' next to the first section provides an overview of the accounts the dapp would like to connect to. The dapp will be able to see the addresses of the selected accounts and can suggest transactions for those specific accounts (e.g., a swap or trade if you have initiated one). You will still have to manually approve these transactions, of course.

4. Tapping 'Edit' next to the the second section will show you which networks the dapp is requesting access to. A dapp that uses multiple networks will be able to seamlessly switch between the enabled networks without needing to prompt you to switch manually.

5. If everything looks good, hit ‘Connect’ to connect the selected accounts and networks with the dapp. You’re now set!

In the future, if the dapp wishes to connect to another account or network for which you have not yet granted permission, it can prompt you to grant these additional permissions. You can modify the granted permissions for the selected accounts and networks anytime.

Manually connect to a dapp

Usually, when you try and connect to a dapp by clicking a 'connect with MetaMask' button—or something with similar wording—MetaMask will pop up and ask if you're happy to do so.

If the dapp to which you're trying to connect doesn't automatically prompt you to connect your MetaMask, or for whatever reason you want to initiate the connection manually, follow these steps:

Extension

Navigate to the site you want to manually connect to, and then click on the MetaMask Extension icon in the browser toolbar in the top-right.

In MetaMask, click on the dapp's icon in the top right corner.

Click "Connect Accounts" to select the account(s) you want to connect to the site. Click "Next" to proceed.

Confirm the permissions you're granting to the dapp.

Voila! You're connected!

tip

You can click on the dapp's icon in the top right of your MetaMask Extension to connect an additional account to the site.

Mobile

Tap on the 'browser' tab at the bottom of the screen:

Next, find the site that you're looking for:

From here, find and tap a button marked 'Connect' or similar—the exact design will vary depending on the dapp—and choose the account(s) you want to use with the dapp.