How to Add Token Logo to Metamask

admin

How to Add Token Logo to Metamask

admin

Adding a token logo to MetaMask for a custom token you've already added is a common request. The process isn't done by the user directly in their wallet, but by the token's developer submitting it to the official community-led registry.

Here’s a breakdown of how it works from both a user's perspective and a developer's perspective.

---

For the User: Why Don't I See a Logo?

When you add a custom token using its contract address, the logo often doesn't appear immediately. This is because MetaMask pulls token logos from a trusted source called Codefi Token Lists, which is a community-curated registry.

If a logo is missing, it means the token's developers have not yet submitted their token to this registry or their submission is still under review.

What you can do as a user:

• Wait: Often, logos appear automatically a few days after the token is launched and the developers complete the submission process.
• Confirm the Contract Address: Double and triple-check that you added the correct, official contract address. Scammers often create fake tokens with fake logos. Always get the address from the project's official website or verified social media.
• Suggest a List (Advanced): You can manually add a community token list that contains the logo. Go to MetaMask Settings -> Security & Privacy -> Scroll down to "Token List" and toggle it on. You can then add a URL to a trusted token list. However, this is less common for individual tokens and carries some risk if the list is not from a trusted source.
  
  

You cannot manually add a logo yourself for security reasons. Allowing this would make it easy for scammers to impersonate legitimate tokens.

---

For the Developer: How to Submit Your Token's Logo

If you are a project developer and want to get your token's logo displayed on MetaMask, Etherscan, and other platforms, you must submit a Pull Request (PR) to the official token list repository.

Here is the step-by-step process:

Step 1: Prepare Your Assets

You will need:

• Token Logo: A high-quality, square image (like 256x256 or 512x512 pixels) in .png or .svg format. The background should be transparent if possible.
• Correct Contract Address: The official, deployed token contract address.
• Project Information: Your token's name, symbol, and decimals.
  
  

Step 2: Fork the Repository

Go to the official Codefi Assets repository on GitHub:
https://github.com/MetaMask/contract-metadata

• Click the "Fork" button in the top-right corner. This creates a copy of the repository under your own GitHub account.
  
  

Step 3: Add Your Token Information

In your forked repository:

• Navigate to the images folder. Add your logo file here. Name it exactly as your token's contract address (case-sensitive!) with the appropriate extension (e.g., 0x1234567890abcdef... .png).
• Navigate to the contract-map.json file. This is the main index file.
• Edit this JSON file to add a new entry for your token. The key must be your lowercase contract address.
  
  

json





{  ...  "0x1234567890abcdef1234567890abcdef12345678": {    "name": "Your Awesome Token",    "logo": "images/0x1234567890abcdef1234567890abcdef12345678.png",    "erc20": true,    "symbol": "AWE",    "decimals": 18  },  ...}

(Replace the example address and details with your actual token information.)

Step 4: Submit a Pull Request (PR)

• After committing your changes to your forked repository, go to the original repository: https://github.com/MetaMask/contract-metadata
• You will see a prompt to "Contribute" and "Open Pull Request." Click it.
• Provide a clear title and description for your PR, such as "Add logo for [Your Token Name] ([Token Symbol])".
• Submit the PR.
  
  

Step 5: Review and Merge

The MetaMask team and community moderators will review your submission. They will check:

• The contract address is valid and on a supported network (like Ethereum Mainnet, Polygon, etc.).
• The logo is high-quality and meets the requirements.
• The information provided matches the on-chain data.
  
  

Once approved and merged, the logo will be distributed and will eventually start appearing in MetaMask wallets for all users. This process can take some time.

---

Important Warning About Security

• For Users: Never trust a token logo alone. A logo does not guarantee legitimacy. Always verify the contract address from multiple official sources before adding any token. Scammers can create tokens with identical names and logos but with a different, malicious contract address.
• For Developers: Do not submit tokens that are meant to impersonate other well-known projects. Such submissions will be rejected, and your GitHub account could be banned from the repository.
  
  

In summary, while users can't directly add logos, developers have a clear path to submit them to the official registry, which benefits all their users.