Skip to main content

Register a token with users

When a user opens MetaMask, they're shown a variety of assets, including tokens. By default, MetaMask detects some major popular tokens and displays them, but for most tokens, the user must register the token themselves. This process can be cumbersome, involves the user interacting with contract addresses, and is error-prone.

You can improve the security and experience of users registering your token on their MetaMask interface by using the wallet_watchAsset RPC method.

For example, you can add something like the following to your project script:

const tokenAddress = '0xd00981105e61274c8a5cd5a88fe7e037d935b513';
const tokenSymbol = 'TUT';
const tokenDecimals = 18;
const tokenImage = '';

try {
// wasAdded is a boolean. Like any RPC method, an error can be thrown.
const wasAdded = await ethereum.request({
method: 'wallet_watchAsset',
params: {
type: 'ERC20', // Initially only supports ERC-20 tokens, but eventually more!
options: {
address: tokenAddress, // The address of the token.
symbol: tokenSymbol, // A ticker symbol or shorthand, up to 5 characters.
decimals: tokenDecimals, // The number of decimals in the token.
image: tokenImage, // A string URL of the token logo.

if (wasAdded) {
console.log('Thanks for your interest!');
} else {
console.log('Your loss!');
} catch (error) {

For more examples, the following are live web dapps that let you enter your token details and share them using a simple web link: