Add a custom token by switching to the correct network, obtaining the contract address from the project’s verified documentation or explorer, and importing that address. Confirm symbol and decimals; adding a token only changes display and does not prove the token is safe.
Understand the moving parts#
Anyone can create a token with a familiar name and ticker. Contract address is the actual identifier, and the same project may have different official contracts across chains.
Common traps#
- Searching by symbol alone. This changes the planned exposure or execution cost of add custom token MetaMask after the decision has already been made.
- Copying a contract from social replies. The branding can be copied, so the request must be re-opened through an independently verified channel.
- Assuming an imported token is liquid. A label can look correct while the underlying destination differs, and a confirmed onchain action may be irreversible.
- Interacting with unsolicited spam tokens. A label can look correct while the underlying destination differs, and a confirmed onchain action may be irreversible.
In add custom token MetaMask, these errors share one pattern: speed or familiarity replaces verification. Slow down at the point where authority, money or an irreversible signature changes hands.
Do it in a controlled sequence#
- Select the intended network. The choice determines which asset, authority or risk model applies, so resolve any ambiguity before the next step.
- Copy the contract from a verified source. For add custom token MetaMask, complete this before value or signing authority changes hands and verify the resulting state afterward.
- Inspect the explorer page and decimals. Compare the live venue details with the written plan; do not rely on a chart label or a remembered setting.
- Import and confirm displayed balance. Compare the live venue details with the written plan; do not rely on a chart label or a remembered setting.
- Verify the same address in the DEX trade. Compare the live venue details with the written plan; do not rely on a chart label or a remembered setting.
The decision framework#
If two official sources do not agree on the contract, do not trade. Resolve the discrepancy through verified documentation.
A final verification pass#
Do not judge the outcome of add custom token MetaMask only by whether the interface shows a success message. Use evidence that can still be checked after the page is closed.
| Checkpoint | Evidence | Stop condition |
|---|---|---|
| Select the intended network | Account history entry and a journal note showing the planned value | Searching by symbol alone |
| Copy the contract from a verified source | Exact URL or contract address matched to official documentation | Copying a contract from social replies |
| Inspect the explorer page and decimals | Account history entry and a journal note showing the planned value | Assuming an imported token is liquid |
Record actual fills, fees and remaining exposure for add custom token MetaMask. The order ticket is an estimate; account history is the durable record.
Frequently asked questions#
Why does my token show zero?
The wallet may be on the wrong network or using the wrong contract, or the address may not own that token.
Can importing a token steal funds?
Importing for display normally cannot; interacting with malicious contracts or links can.
What are token decimals?
They define how raw integer balances are displayed as user-facing units.
Related guides#
Sources#
- Uniswap Support: Swaps and Troubleshooting
- Ethereum.org: Gas and Fees
- MetaMask: Transactions and Gas
Risk notice: Crypto trading can produce rapid losses. Examples are educational, not personalized financial advice; verify venue rules, fees and legal or tax obligations before acting.
Editorial standard
This guide is educational and source-led. Security controls, exchange rules and legal requirements can change; verify critical steps through the relevant official service before acting.
