Skip to main content
Tutorial Last updated: September 24, 2026 6 min read

How to Add a Custom Token to Phantom Wallet

Written by the CreateMyCoin Team

Quick answer: Open Phantom → your token list → Manage Token List → paste the token's mint address into the search field → toggle it visible. Your tokens were never missing; Phantom hides unlisted tokens by default to cut spam. You can confirm the balance any time by pasting your wallet address into Solscan.

This is the single most common moment of panic after minting a token: the transaction succeeded, Solscan shows the supply, and Phantom shows nothing. Nothing has gone wrong. Here's the 30-second fix, and the permanent fix that makes your token display properly for everyone else too.

Why Isn't My Token Showing?

Phantom doesn't display every token in your wallet by default. Anyone can send anyone an SPL token for a fraction of a cent, which means spam and scam tokens get airdropped into wallets constantly. To keep the interface usable, Phantom shows tokens that appear on a verified token list and hides the rest behind a manual toggle.

A token you just created has no trading history and isn't on any list yet, so it falls into the hidden bucket. This is expected behaviour, not a failure.

Confirm your tokens are actually there first. Paste your wallet address into solscan.io and open the token holdings tab. If the balance appears there, the tokens are in your wallet and this is purely a display issue. Solscan reads the chain directly and doesn't filter by token list. The fuller walkthrough is in how to verify a token on Solscan.

Find Your Token's Mint Address

On Solana, the mint address is what Ethereum users would call the contract address. It's the unique identifier of your token — a string of roughly 32 to 44 characters.

Where to find it:

  • You just created the token: it's on your creation confirmation screen. CreateMyCoin shows it directly after minting, along with a Solscan link.
  • Someone sent you the token: get the address from the project's official site, its verified social account, or its DexScreener page — never from a DM.
  • From the transaction: open your wallet address on Solscan, find the transfer, and the token mint is linked in the transaction details.

Verify the address against an official source. Scammers create tokens with identical names and logos to real projects — the mint address is the only thing that distinguishes them. A token called "BONK" with the wrong mint address is a different, worthless token. Cross-check on DexScreener or the project's verified channels.

Add the Token in Phantom

Step 1 — Open your token list

Open the Phantom extension and stay on the main account screen where your SOL balance and tokens are listed.

Step 2 — Open "Manage Token List"

Scroll to the bottom of your token list, or use the manage/settings icon on the list itself. Phantom's exact placement shifts between versions — look for "Manage Token List."

Step 3 — Paste the mint address

Paste the full mint address into the search field. Phantom searches by address as well as name, so an unlisted token still resolves. Searching by the token's name often won't find it — use the address.

Step 4 — Toggle it on

Switch the toggle for that token. It now appears permanently in your main token list with your balance. This setting is local to your wallet on this device — it doesn't change anything on-chain and doesn't affect what other people see.

On Mobile

The flow is the same in the Phantom mobile app: open your token list, tap the manage icon (usually top-right of the list), search by mint address, toggle visible.

Because the visibility setting is stored per device, you'll need to repeat it in the mobile app even if you've already done it in the extension — the same wallet, but two separate display preferences. If you created your token from a phone, see creating a Solana token on mobile.

Why Does It Say "Unknown Token"?

This is a different problem from the token being hidden, and it points at your token rather than at Phantom.

Phantom reads a token's name, symbol and logo from a Metaplex metadata account attached to the mint. If it displays "Unknown Token," one of these is true:

  • No metadata account was created. The token exists but has no name or symbol attached. This happens when a token is minted with raw CLI commands and the metadata step is skipped.
  • The metadata URI is broken. The account exists and points at a JSON file that is unreachable, malformed, or hosted somewhere that's gone offline.
  • The image URL is dead — the name and symbol show, but the logo slot is empty.

It can also simply be propagation delay in the first minute or two after minting. Wait, then reload.

The Permanent Fix for Token Creators

Getting your own token to show in your wallet is cosmetic. Getting it to show correctly in everyone's wallet is a launch requirement — a token displaying as "Unknown Token" with a blank logo reads as abandoned or fake, and it's on the list of token red flags that make buyers walk away.

Three things to get right:

  1. Attach proper metadata at creation. Name, symbol, description, and a logo hosted somewhere permanent. Tokens created through CreateMyCoin get a Metaplex metadata account by default, which is why they render correctly immediately. The standards are covered in SPL token metadata best practices.
  2. Host the image durably. A logo on a personal server that lapses will break every wallet display months later. If the metadata is already wrong, you can update your token's metadata — provided you haven't revoked the update authority yet.
  3. Get on a verified token list. This is what makes the token appear automatically for people who haven't added it manually. It follows from real liquidity and trading activity rather than an application form — see getting listed on Jupiter and getting listed on CoinGecko.

A Safety Warning About Unexpected Tokens

If a token you never bought appears in your wallet, do not interact with it. Unsolicited airdrops are a standard attack pattern: the token's name or metadata contains a URL promising a claim or a swap, and the site it leads to asks you to sign a transaction that drains your wallet.

Don't try to sell it, swap it, or "claim" anything. Hide it and ignore it. The token sitting in your wallet is harmless on its own — the damage only happens when you sign something. This is covered in detail in Solana wallet drainers.

FAQ

Why is my token not showing in Phantom?

Almost always because it isn't on a verified token list yet, so Phantom hides it by default to reduce spam. The tokens are still in your wallet. Add it manually by mint address, or check your balance on Solscan to confirm.

How do I add a token to Phantom by contract address?

Open Phantom → token list → Manage Token List → paste the mint address into the search field → toggle it visible. Solana calls it a mint address rather than a contract address, but it's the same thing.

Why does my token show as "Unknown Token" in Phantom?

The token has no on-chain metadata, or its metadata URI is broken. Phantom reads the name, symbol and logo from a Metaplex metadata account attached to the mint — without valid metadata there's nothing to display.

Do I need to add my own token to Phantom after creating it?

Usually not, if it was created with proper metadata — it should appear within a minute or two. If it doesn't, add it manually and check that metadata was attached correctly during creation.

Is it safe to add a custom token to Phantom?

Adding a token to your display list is safe — it changes nothing on-chain and grants no permissions. The risk is interacting with unsolicited tokens or visiting URLs found in a token's name or metadata.

How long does it take for a new token to appear in Phantom?

A token with valid metadata usually appears within a minute of the mint confirming. Logos can take longer on slow storage. Appearing automatically in other people's wallets requires getting picked up by a verified token list, which follows liquidity and trading activity.

Can I remove a token from my Phantom token list?

Yes. Go back to Manage Token List and toggle it off. This only hides it from your view — the tokens remain in your wallet on-chain.

Create a Token That Displays Properly

CreateMyCoin attaches full Metaplex metadata at mint, so your name, symbol and logo render correctly in Phantom from the first second.

Create Your Solana Token →