Skip to main content

How wallet connection works

This app uses your wallet to sign transactions securely. We never have access to your private keys or funds. You remain in full control at all times.

Troubleshooting

Solana Token Not
Showing in Wallet

Troubleshooting guide for when your Solana token doesn't appear in your wallet. Common causes and step-by-step solutions to fix display issues.

If your Solana token isn't appearing in your wallet, there are several common causes. This guide covers the most frequent issues and how to fix them quickly.

Most Common Causes

The majority of "token not showing" issues stem from a few simple problems:

Token not added manually Zero token balance Incorrect mint address Network mismatch Metadata not configured

Solutions

1

Add Token Manually

Wallets don't automatically detect new tokens. You must add them manually using the mint address. Here's how:

  1. Open your wallet (Phantom, Solflare, etc.)
  2. Find "Add Token", "Import Token", or "Manage Token List"
  3. Enter your token's mint address (the address received after creation)
  4. Verify the token details match (name, symbol, decimals)
  5. Confirm - the token should appear

If you don't have the mint address, check the transaction confirmation or block explorer (Solscan) where you created the token.

2

Check Your Balance

Some wallets hide tokens with zero balance. If you created a token but haven't received any tokens yet, it might not appear.

To see zero-balance tokens in Phantom, go to Settings and enable "Show Zero Balances". Other wallets have similar options in their settings menus.

If you should have tokens but the balance shows zero, verify the transaction completed successfully on Solscan.

3

Verify the Mint Address

Double-check you're using the correct mint address. Mint addresses are long base58 strings that look similar, so it's easy to make a typo.

You can verify the mint address on Solscan by searching for your wallet address and checking the tokens associated with it. The mint address should match exactly.

4

Check Network Settings

Ensure your wallet is connected to the correct network. If you created your token on Solana mainnet, your wallet must be on mainnet to see it. If you created it on devnet, you need to switch to devnet.

Most token creation platforms use mainnet by default. Check your wallet's network setting (usually in Settings or the network selector) and ensure it matches where you created the token.

5

Metadata Issues

If the token appears but shows no name, symbol, or logo, there's likely a metadata problem. This can happen if:

  • Metadata wasn't uploaded during token creation
  • Metadata URI is incorrect or inaccessible
  • Metadata format doesn't match the standard

You can verify metadata on Solscan by viewing your token's page. If metadata is missing, you may need to recreate the token with proper metadata. Learn more about token metadata.

6

Refresh or Reconnect

Sometimes wallets need a refresh to detect new tokens. Try:

  • Refreshing the wallet interface
  • Disconnecting and reconnecting your wallet
  • Clearing the wallet cache (if the option exists)
  • Restarting the browser or app
7

Check Token Creation Status

Verify that your token creation transaction actually completed. Go to Solscan and search for your wallet address or the transaction signature you received.

If the transaction failed or is still pending, the token won't exist yet. Check the transaction status and wait for confirmation if it's still processing.

Wallet-Specific Notes

Different wallets handle tokens slightly differently:

Phantom

Usually reliable. Check Settings for "Show Zero Balances" if the token doesn't appear after adding the mint address.

Solflare

May require manual token addition. Check the token management section within the wallet settings.

Mobile Wallets

Some mobile wallets have delayed token detection. Try pulling down to refresh the asset list.

Hardware Wallets

Ensure the Solana app is installed and updated on the device. Connect through a compatible software wallet.

Still Not Working?

If none of these solutions work:

  • Verify the token exists on Solscan using the mint address
  • Check that you're using a supported wallet (see our wallet support guide)
  • Ensure your wallet software is up to date
  • Try a different wallet to see if the issue is wallet-specific

If the token appears on Solscan but not in your wallet, the issue is likely with wallet configuration rather than the token itself.

FAQ

Frequently Asked Questions

Why is my Solana token not showing in my wallet?
The most common reasons a Solana token does not show in your wallet are: the wallet has not indexed the new token yet (usually resolved within a few minutes), the token has not been added manually, the token metadata is incomplete so the wallet cannot display it, or you are looking at the wrong wallet address. Try refreshing your wallet or adding the token manually using its mint address.
How do I manually add a token to Phantom wallet?
In Phantom, open your wallet and tap the search icon or 'Manage token list'. Enter your token's mint address to find it and add it. Once added, it will appear in your wallet balance. You can find your mint address on Solscan or in the transaction details from when the token was created.
How long does it take for a new Solana token to appear in wallets?
On Solana, transactions confirm within seconds. Your token should appear in your wallet almost immediately after creation. If it does not show up within a few minutes, try refreshing the wallet app, searching by mint address, or checking the transaction on Solscan to confirm it succeeded.
Why does my Solana token show as 'Unknown Token'?
A token appears as 'Unknown Token' when it has no on-chain metadata or the wallet cannot load the metadata. This usually means the token was created without a name, symbol, or image, or the metadata URI is broken. You can update the metadata if you still hold update authority, or use the mint address to identify the token.

Ready to launch?

Create your Solana token today

Our platform ensures tokens are created correctly with proper metadata, reducing the chance of display issues.

Written by

· Founder & Solana Developer

Graham founded SOLTokenLaunch in 2025 and has built no-code SPL token tooling used by creators worldwide. He writes about SPL token standards, Metaplex metadata, mint/freeze/update authority, Raydium liquidity, and Solana mainnet deployment.

Last updated