How to add a token to MetaMask
This article is intended for token developers and teams. If you simply want to see tokens in your MetaMask that you think you own but aren't appearing, consult this article.
The challenge of managing token lists in a wallet
Since the beginning of EVM wallet software, MetaMask has been at the front lines of token-user interfaces. This sounds obvious, but it means balancing the permissionless nature of this technology ("anyone can create a token for anything") with safety ("I thought I was buying a legit token but it was a fake") and convenience ("why won't you just show me the tokens that are in this account?").
The co-founders of MetaMask, kumavis and Dan Finlay, first confronted this issue. Their approach is still a guiding instinct at MetaMask: As the user base of crypto broadens and diversifies, we must strive to keep users safe, in a way that is unopinionated and permissionless as possible. We also have to meet the users and the ecosystem where they are. Often, this means making "convenience features" that rely on centralized solutions, managed by MetaMask, always with the express goal of finding a decentralized, permissionless replacement system as soon as practicable.
In a sense, the core work of so many functions of running MetaMask is "figuring out how to keep lists of things, ideally in the most decentralized and open way possible."
How to get your token to auto-display in MetaMask
Currently, the token search box and the auto-detect functions are a part of a centralized solution. For detailed, step-by-step instructions on how to get your token name and logo added to MetaMask, consult the steps outlined here.
We encourage developers to use the EIP-747 method for making tokens visible. You can find more information about this in MetaMask's technical documentation.
In the above link, you can find instructions on how to integrate the _wallet_watchAsset API as defined in EIP-747. This will let your users easily add your token to their MetaMask wallet, and see it.
How to get correct price information for your token to display in MetaMask
MetaMask sources price information from a number of sources. The best way for your price information to be included in those sources, and thereby to be shown to users in MetaMask, is to ensure that your token is listed on prominent DEXs or CEXs. Maintaining an authoritative list of these sources is impracticable, for the above-mentioned reasons.
Having issues?
As always, if some part of this process isn't working right, open a ticket with our Support team from the button on the home page of this site.