How to use the bridge
Does this article need to be translated?
Want to bridge to a network you've never used before? Read this first!
Before you move your funds onto another network, remember that you'll need native tokens on that network to cover gas fees and use your tokens further. One option is to buy them through our Buy feature.
You can use the MetaMask Bridge feature to not only move your tokens to a different network, but swap them into a different token of your choice, all as part of the same transaction. You might see this practice referred to elsewhere as "cross-chain swaps".
MetaMask pulls together bridging quotes for you to choose from, and you pick the best quote for you. Think of it as an aggregator of aggregators, or meta-aggregator. It's analogous to visiting travel sites that find you the cheapest flight from numerous airlines, or — slightly closer to home — using MetaMask Swaps to find you the cheapest token swap quote from decentralized exchanges.
What is a bridge?
A bridge allows you to swap your tokens across different blockchain networks. For example, perhaps you want to use a dapp or a game on the Polygon network, but most of your funds are on Ethereum mainnet. You can use a bridge to transfer some ETH, USDC, or other tokens from Ethereum to Polygon, and swap them into different tokens if you'd like. You'd then have what you need to start using dapps on Polygon.
Learn more about bridges
To dive a bit deeper:
At their most basic level, bridges are platforms with contracts on the chains you're transferring to and from. Though the exact system varies, each bridge has a mechanism to validate your deposit on one network and issue equivalent tokens on another network.
When you request to move Ethereum from Mainnet to Polygon, for example, the first thing the bridge will need to do is have you deposit the ETH to the bridge. The bridge will prompt you to sign a transaction to send the tokens to their address (for tokens other than ETH, this assumes you've already signed an approval granting it access to your tokens).
The deposit may be validated in a few different ways depending on the bridge, but this process essentially buys you the right to have your target address credited with the agreed amount of tokens (that is: the token you're bridging to). The bridge honors this request by minting or sending the tokens to the account you specified on the destination network.
Where can I find it?
You can bridge in MetaMask Extension or MetaMask Portfolio.
- Extension
- Portfolio
-
Click the 'Bridge' button from the homepage of MetaMask Extension.
-
On the right side of the screen, select the token and network you want to bridge from.
-
On the left side of the screen, input the amount of tokens you want to bridge. You can adjust this amount at any time before initiating the bridge.
-
Click 'Bridge to', and select the network you want to bridge to and the token you want to receive.
-
The screen will update with the amount of tokens you'll receive based on available quotes. You can select 'More quotes' to browse other options, or click 'Submit' to confirm the transaction.
Your bridge is now in progress! You can view the status of your bridge in the 'Activity' tab of MetaMask Extension.
- Select 'Move Crypto' from the left-hand menu, and then click 'Bridge'.
-
Make sure your wallet is connected and that you've selected the account that has the tokens you want to bridge.
-
Select the network from which you want to move tokens under the 'From this network' field.
-
Input the details of the token you want to bridge under 'You send'. The drop-down list in this field is divided into tokens that are 'Able to bridge' and those that you're 'Unable to bridge'. The category each token belongs to depends on:
- Whether we currently support that token
- Whether you hold that token in your wallet.
-
Pick the network to which you want to bridge the tokens under 'To this network'.
-
If you're bridging to the same token: When you input a token and an amount to send, the aggregator will start to find quotes. Once it's done, you'll see how much of the token you'll receive on the destination network, and your quote is listed under 'Recommended Bridge' below.
If you're bridging to a different token: You can receive a different token on the destination network, if you choose, by selecting a different token under 'You receive'.
-
Assess the quote and its estimated timings and fees by clicking the drop-down arrow on its right side. The quote will refresh every minute to ensure you get up-to-date information.
-
If you want to view other quotes, hit 'Choose a different quote' in the top-right of the quote field. Click on one to select it.
-
When you're happy with the quote, click the 'select' button. This will call up a window that asks you to sign a message using your wallet. Follow the prompt and MetaMask will open to allow you to do so, and then proceed through to initiate the bridge.
Note that you may need to approve MetaMask Portfolio's access to your tokens before you can bridge them. Read more on token approvals here.
FAQs
What networks are supported?
You can bridge between:
- Ethereum mainnet
- Polygon
- BNB Smart Chain
- Avalanche
- Arbitrum
- Optimism
- Linea
- zkSync Era
- Base.
What tokens are supported?
We recently enabled bridging to different tokens. Since this process involves swaps, you can bridge to any token with sufficient liquidity on the protocols we use as providers. To see what's available, please check on the Bridge page.
Does MetaMask take custody of my funds at any point?
No, we work with third parties to bridge your tokens between networks.
Do you make money from this?
Yes. Like MetaMask Swaps, we apply a 0.875% fee on each transaction. This is calculated based on the total value of the transaction before fees are subtracted.
So if you want to bridge 1,000 USDT, for example, the MetaMask fee would be 8.75 USDT, and then other fees and costs will be subtracted from the remaining 991.25 USDT.
This means that when you use the Bridge feature, you pay:
- The MetaMask fee
- Gas fees on the source network
- The difference in the value of the token you send vs. the value of tokens you receive on the destination network. This includes any fees charged by the bridge providers, as well as gas fees on the destination network.
I haven't received my tokens in the time I should have. What should I do?
The time we quote is an estimate, and delays can happen for several reasons, such as a change in network conditions. In most cases, the bridge transfer is just delayed and your transfer will still go through automatically.
If you've already waited over three hours and your transfer is still in progress, please contact MetaMask Support by clicking the 'support' button in the bottom left of the dapp. If we cannot troubleshoot the problem, we recommend that you contact the bridge's support to look into getting your transaction unstuck.
What aggregators and bridges do you use?
As we described above, our platform sources bridging options through two stages:
- Aggregators, through which we access a selection of:
- Bridge providers, the platforms that actually execute the bridge.
The aggregators we use are LI.FI and Socket. The bridge providers we access through these aggregators are:
- Hop
- Celer cBridge
- Polygon PoS Bridge
- Squid (Axelar)
- Across
- Stargate
What is the maximum transaction size?
The maximum value you can bridge at a time is $50,000.
Something went wrong with my transfer. What do I do?
Don't panic! Just contact Support via the button on the bottom right of this article.
Why does it say I'm on an 'Unsupported network'?
The Bridge feature automatically adopts the same network that your MetaMask wallet is set to. Make sure your wallet is set to one of the supported networks listed above, and then you will be able to bridge.