If a token is already indexed by major platforms (e.g. CoinGecko, CoinMarketCap, Etherscan), you can use their “Add to MetaMask” buttons to import both the token and its official logo. If the token isn’t yet indexed—or you want full control over the appearance—integrate MetaMask’s wallet_watchAsset API in your own website or DApp to prompt users to add the token with your custom logo.
I. Quick Manual Methods for Users
1. Via CoinGecko
-
Open the token’s page on CoinGecko.
-
Click the “Add to MetaMask” (fox icon) button.
-
Confirm in the MetaMask popup to import the token and its logo.
Tip: Supported on both desktop and mobile; on mobile, open CoinGecko in MetaMask’s built‑in browser.
2. Via CoinMarketCap
-
Visit the token’s detail page on CoinMarketCap.
-
Click the fox icon next to the token name.
-
Confirm in the wallet popup to add the token and logo.
3. Via Block Explorers (Etherscan, BscScan, Polygonscan, etc.)
-
Navigate to the token’s contract page on the relevant explorer.
-
From the “More” menu, select “Add token to MetaMask.”
-
Confirm in the MetaMask dialog to import the logo along with the token.
Note: If the explorer itself doesn’t yet display a logo, you must first submit the logo (via PR or support request) to that explorer.
II. Automatic Integration for Developers (EIP‑747)
Token issuers or DApp developers can leverage MetaMask’s wallet_watchAsset RPC to trigger an “Add Asset” popup with your custom logo.
1. API Overview
-
Method:
wallet_watchAsset -
Standard: EIP‑747 (Ethereum Improvement Proposal)
-
Purpose: Prompts MetaMask to add a specified token (with logo) to the user’s asset list.
2. Example Code
const tokenAddress = “0xYourTokenContractAddress”;
const tokenSymbol = “SYM”; // ≤5 characters
const tokenDecimals= 18; // decimals
const tokenImage = “https://yourdomain/logo.png”; // must use HTTPStry {
const wasAdded = await window.ethereum.request({
method: “wallet_watchAsset”,
params: {
type: “ERC20”, // or other supported types
options: {
address: tokenAddress,
symbol: tokenSymbol,
decimals: tokenDecimals,
image: tokenImage,
},
},
});
if (wasAdded) {
console.log(“Token successfully added to MetaMask!”);
} else {
console.log(“User rejected the request.”);
}
} catch (error) {
console.error(“Failed to add token:”, error);
}
This also works for experimental NFT support and other EVM‑based tokens.
III. Important Notes
-
HTTPS Logo: The image URL must use HTTPS.
-
Network Matching: Ensure the user’s network matches the token’s chain ID.
-
Centralized Indexing: MetaMask’s built‑in search relies on its own database; unlisted tokens still require manual or API methods.
-
Security Reminder: Only add tokens from trusted sources to avoid phishing or fake logos.
By following the user manual and developer integration approaches above, you can ensure your token—and its logo—appear correctly in MetaMask.
© Original content by PandaAcademy
Unauthorized reproduction prohibited. Credit required when sharing.
PandaAcademy, a Web3 educational brand by PandaTool, positions as an open skills academy for the Web3 era.
本文由PandaAcademy原创，如若转载，请注明出处：https://academy.pandatool.org/en_US/kn/974
。PandaAcademy是PandaTool旗下的Web3学习中心，专注于向普通用户提供区块链和加密货币知识输出
Comments(84)
Hi there, just became aware of your blog through Google, and found that it is really informative. I’m gonna watch out for brussels. I’ll appreciate if you continue this in future. Lots of people will be benefited from your writing. Cheers!
There may be noticeably a bundle to learn about this. I assume you made sure nice factors in options also.
hey there and thank you for your information – I have certainly picked up something new from right here. I did however expertise several technical points using this site, as I experienced to reload the site a lot of times previous to I could get it to load properly. I had been wondering if your hosting is OK? Not that I’m complaining, but slow loading instances times will sometimes affect your placement in google and could damage your quality score if ads and marketing with Adwords. Anyway I’m adding this RSS to my email and can look out for much more of your respective interesting content. Ensure that you update this again very soon..
Awesome site you have here but I was curious if you knew of any message boards that cover the same topics discussed here? I’d really like to be a part of community where I can get suggestions from other knowledgeable people that share the same interest. If you have any suggestions, please let me know. Thank you!
I was recommended this website by my cousin. I am not sure whether this post is written by him as nobody else know such detailed about my trouble. You are amazing! Thanks!
My partner and I absolutely love your blog and find a lot of your post’s to be exactly what I’m looking for. Would you offer guest writers to write content in your case? I wouldn’t mind creating a post or elaborating on some of the subjects you write with regards to here. Again, awesome web log!
Oh my goodness! an incredible article dude. Thank you Nonetheless I’m experiencing issue with ur rss . Don’t know why Unable to subscribe to it. Is there anyone getting an identical rss downside? Anyone who is aware of kindly respond. Thnkx
Can I just say what a relief to find someone who actually knows what theyre talking about on the internet. You definitely know how to bring an issue to light and make it important. More people need to read this and understand this side of the story. I cant believe youre not more popular because you definitely have the gift.
It is appropriate time to make some plans for the future and it’s time to be happy. I’ve read this post and if I could I wish to suggest you some interesting things or tips. Maybe you can write next articles referring to this article. I desire to read more things about it!
Absolutely written content material, thank you for information. “The earth was made round so we would not see too far down the road.” by Karen Blixen.
Some genuinely interesting points you have written.Helped me a lot, just what I was looking for : D.
I got what you intend, thankyou for posting.Woh I am delighted to find this website through google. “Since the Exodus, freedom has always spoken with a Hebrew accent.” by Heinrich Heine.
I really like your blog.. very nice colors & theme. Did you create this website yourself or did you hire someone to do it for you? Plz answer back as I’m looking to create my own blog and would like to know where u got this from. kudos
Undeniably believe that which you stated. Your favorite reason seemed to be on the web the simplest thing to understand of. I say to you, I certainly get annoyed even as other folks think about issues that they just do not recognise about. You managed to hit the nail upon the highest as neatly as outlined out the entire thing without having side effect , people can take a signal. Will likely be again to get more. Thanks
What¦s Going down i’m new to this, I stumbled upon this I’ve found It positively useful and it has aided me out loads. I hope to contribute & assist different users like its helped me. Good job.
I will immediately grasp your rss feed as I can not to find your email subscription link or e-newsletter service. Do you’ve any? Kindly allow me recognize so that I may just subscribe. Thanks.
I am constantly searching online for posts that can help me. Thank you!
Thank you a lot for providing individuals with an extremely nice chance to check tips from this site. It’s always so beneficial and jam-packed with a lot of fun for me personally and my office fellow workers to search your website the equivalent of three times a week to learn the newest secrets you will have. Of course, we are always satisfied with the outstanding hints served by you. Certain 2 ideas in this article are honestly the most suitable I have had.
My spouse and I stumbled over here different page and thought I might as well check things out. I like what I see so i am just following you. Look forward to finding out about your web page yet again.
Hi! I just wanted to ask if you ever have any problems with hackers? My last blog (wordpress) was hacked and I ended up losing a few months of hard work due to no data backup. Do you have any solutions to prevent hackers?
naturally like your web site but you have to check the spelling on quite a few of your posts. A number of them are rife with spelling issues and I in finding it very bothersome to tell the truth nevertheless I will certainly come again again.
Thank you for another informative web site. The place else may I get that kind of information written in such an ideal approach? I have a challenge that I’m just now working on, and I’ve been on the look out for such info.
Hmm is anyone else encountering problems with the images on this blog loading? I’m trying to figure out if its a problem on my end or if it’s the blog. Any feed-back would be greatly appreciated.
Valuable info. Lucky me I discovered your web site unintentionally, and I’m surprised why this coincidence did not happened in advance! I bookmarked it.
I used to be recommended this website via my cousin. I’m now not certain whether this post is written by means of him as nobody else recognize such exact about my difficulty. You are wonderful! Thanks!
Hello there, I found your website via Google while looking for a related topic, your site came up, it looks great. I have bookmarked it in my google bookmarks.
I have been checking out many of your stories and i can state pretty nice stuff. I will surely bookmark your blog.
I got good info from your blog
Outstanding post, you have pointed out some good details , I also think this s a very great website.
I have not checked in here for a while since I thought it was getting boring, but the last few posts are good quality so I guess I will add you back to my everyday bloglist. You deserve it my friend :)
When I initially commented I clicked the “Notify me when new comments are added” checkbox and now each time a comment is added I get three emails with the same comment. Is there any way you can remove me from that service? Many thanks!
Very interesting information!Perfect just what I was searching for! “Oh, I don’t blame Congress. If I had 600 billion at my disposal, I’d be irresponsible, too.” by Lichty and Wagner.
Great write-up, I am regular visitor of one’s website, maintain up the nice operate, and It is going to be a regular visitor for a long time.
you are really a good webmaster. The web site loading speed is amazing. It seems that you’re doing any unique trick. Also, The contents are masterwork. you have done a great job on this topic!