How to add an ERC-721 or ERC-1155 token to MetaMask?

MetaMask supports ERC-721 and ERC-1155 tokens, which can be manually added using their contract addresses and are displayed under the "Collectibles" tab.

Jul 02, 2025 at 04:01 am

Understanding ERC-721 and ERC-1155 Tokens

ERC-721 and ERC-1155 are two of the most popular token standards on the Ethereum blockchain. ERC-721 is primarily used for non-fungible tokens (NFTs), where each token represents a unique asset. On the other hand, ERC-1155 allows for both fungible and non-fungible tokens within the same contract, making it more flexible and efficient in certain applications.

Before adding these tokens to your wallet, it’s essential to understand that MetaMask, one of the leading Ethereum wallets, supports both types of tokens. However, unlike ERC-20 tokens, which can be automatically detected or added through a simple process, ERC-721 and ERC-1155 tokens require manual addition using specific contract addresses.

Prerequisites Before Adding Tokens

To successfully add an ERC-721 or ERC-1155 token to MetaMask, ensure you have the following:

• A functioning MetaMask wallet installed as a browser extension or mobile app.
• The correct contract address of the token you want to add.
• Access to the Ethereum network (or the appropriate network where the token exists).
• Knowledge of whether the token is ERC-721 or ERC-1155, although MetaMask handles both similarly when adding manually.

If you're unsure about the contract address, check the NFT marketplace where you purchased the token, such as OpenSea, Rarible, or LooksRare. Most platforms display the contract address in the NFT details section.

Steps to Add an ERC-721 or ERC-1155 Token Manually

To manually add a token to MetaMask, follow these steps:

• Open your MetaMask wallet and ensure you're connected to the correct network where the token resides (e.g., Ethereum Mainnet, Polygon, etc.).
• Navigate to the "Assets" tab located at the top of the wallet interface.
• Click on the "Import Tokens" button found near the bottom of the screen.
• In the pop-up window, select the "Custom Token" tab.
• Paste the token contract address into the designated field.
• Wait for MetaMask to fetch the token symbol and decimals automatically. If it fails, you may need to enter them manually if available.
• Confirm by clicking the "Next" button, followed by "Add Tokens".

Once completed, the token should appear under your "Collectibles" tab if it's an ERC-721 or ERC-1155.

Locating Added Tokens in MetaMask

After importing, ERC-721 and ERC-1155 tokens will not appear in the main "Tokens" section. Instead, they are displayed in the "Collectibles" section of your wallet. To access them:

• Open your MetaMask wallet.
• Click on the "Collectibles" tab.
• You should see all imported collectibles listed here, including their thumbnails and basic information.

If a thumbnail doesn’t load immediately, wait a few moments or refresh the wallet. Sometimes images take time to fetch from decentralized storage like IPFS.

Troubleshooting Common Issues

Sometimes users face issues when trying to add ERC-721 or ERC-1155 tokens to MetaMask. Here are some common problems and how to resolve them:

• Token Doesn't Appear After Importing: Double-check the contract address for any typos or incorrect characters. Also, ensure you're on the correct network.
• Thumbnail Not Loading: This is often due to slow image loading from decentralized sources. Try refreshing or waiting a few minutes.
• Incorrect Network Selected: Make sure the network in MetaMask matches the network where the token was issued. For example, if the token is on Polygon, switch MetaMask to the Polygon Mainnet before importing.
• Token Symbol Not Detected: Some contracts don’t expose metadata correctly. If this happens, you can still add the token but will have to rely on external tools to verify ownership and metadata.

If none of these solutions work, consider reaching out to the platform or community where you obtained the token for further assistance.

Connecting with External Platforms

Many NFT marketplaces allow direct connection to MetaMask, enabling seamless viewing and management of ERC-721 and ERC-1155 tokens. However, sometimes tokens might not sync immediately due to caching or metadata issues.

To ensure synchronization:

• Disconnect and reconnect your MetaMask wallet to the platform.
• Clear the cache or cookies in your browser if using a web-based wallet.
• Use the "Refresh Metadata" option if available on the platform.

This ensures that the latest state of your collectibles is reflected across both the wallet and the marketplace.

---

Frequently Asked Questions

Q: Can I add multiple ERC-721 or ERC-1155 tokens at once?

A: No, MetaMask currently allows only one token to be added at a time manually. You must repeat the import process for each token.

Q: What should I do if the contract address changes?

A: Contract addresses are immutable once deployed on the blockchain. If you believe there's a change, verify the source or contact the project team, as it could indicate misinformation or fraud.

Q: Do I need to pay gas fees to add tokens to MetaMask?

A: No, adding tokens to MetaMask does not require any transaction or gas fee. It's purely a view-only action.

Q: Why are my ERC-1155 tokens showing up as separate entries for each ID?

A: This is normal behavior. ERC-1155 tokens support multiple IDs within a single contract, and MetaMask lists each ID separately under the "Collectibles" tab.