How to Add a Token to Your Phantom Wallet (2026)

In most cases you don't need to "add" a Solana token to Phantom — it shows up automatically the moment your wallet holds any balance of it. But there are a few situations where you need to add or unhide a token manually. Here's how, and how to avoid the spam-token problem at the same time.

The default: tokens appear automatically

When you create or receive any SPL token on Solana mainnet:

1. The token's Metaplex metadata is fetched by Phantom
2. The logo and name are rendered in your token list
3. The token balance is shown in your portfolio

This works for any standard SPL token. If yours doesn't appear, one of three things is happening:

• The token has no Metaplex metadata (it'll show as "Unknown Token")
• Phantom is filtering it as spam (often the case for airdropped tokens)
• You're looking on the wrong network (devnet vs mainnet)

Method 1 — Unhide a hidden token

Phantom hides tokens it considers spam by default. To unhide:

1. Open Phantom
2. Tap the manage tokens button (sliders icon, top right of the home tab)
3. Search for your token by name or paste the mint address
4. Toggle visibility on

The token will now show in your main list.

Method 2 — Add by mint address

If a token isn't appearing even after unhide:

1. Open Phantom → Manage tokens → + (top right)
2. Paste the mint address (the long base58 string — find it on Solscan, Birdeye, or in the share link from whoever sent it to you)
3. Phantom fetches the on-chain Metaplex metadata and renders the token

If the metadata is missing, Phantom shows "Unknown Token" with a placeholder icon. That's a problem on the token's side, not your wallet — a properly launched SPL token always has metadata. Tokens minted via SolanaForge always do.

Method 3 — Network check

If you're testing a token you minted yourself and it's not showing:

1. Open Phantom → Settings → Developer Settings → Change Network
2. Make sure it says Mainnet Beta
3. If it says Devnet or Testnet, switch to Mainnet Beta and check again

If your token was minted on devnet by a "free" launchpad, switching back to mainnet means the token will never appear — it doesn't exist on mainnet. There's no bridge from devnet. You'd need to remint on the real chain. (See Mainnet vs Devnet.)

How to avoid Phantom spam-filtering your token

If you've launched a token and your holders are reporting it as hidden:

• Mint authority must be revoked. Phantom (and most aggregators) flag tokens with live mint authority as higher-risk.
• Freeze authority should be revoked. Same reason.
• Metaplex metadata must be properly formed — name, symbol, URI, plus a valid IPFS-pinned JSON.
• The logo must load — broken IPFS pins (because you used a free pin that expired) cause "Unknown Token" rendering.
• Don't airdrop to random wallets. Phantom's spam filter heuristics weigh "received from a wallet that airdropped many small balances" heavily.

SolanaForge bakes the first four into every mint (revokes are atomic, metadata is Metaplex MetadataV3, Pinata IPFS is paid and persistent). The 5th is up to your distribution strategy.

Method 4 — Add custom token list entry (advanced)

If you're building a frontend and want your token to render with the correct logo across every wallet, submit it to:

• Jupiter strict list — community-vetted, used by Phantom, Jupiter, and many other apps
• Solana token list — older but still consulted by some explorers

Both require the Metaplex metadata to already be correct on-chain. Submission is via a PR or web form depending on the list.

Bottom line

For receiving and using existing tokens, Phantom adds them automatically — you only need to unhide if they're spam-filtered. For your own newly launched token, the fix is always at the mint level: revoke authorities, attach Metaplex metadata, pin the logo to IPFS, and Phantom will render it everywhere.

Launch a properly configured Solana token →