How to add a custom token to Phantom wallet?

Phantom Wallet allows users to add custom SPL tokens by manually entering the token address, symbol, name, and decimals for better balance management.

Jul 05, 2025 at 07:17 pm

Understanding Custom Tokens in Phantom Wallet

Phantom wallet is a non-custodial wallet primarily used for interacting with the Solana blockchain. While it supports many popular tokens by default, users may need to add custom tokens that are not automatically recognized. A custom token typically refers to any SPL token that hasn’t been pre-added to Phantom’s interface. Adding such tokens allows users to view and manage balances directly within the wallet.

To proceed, users must have accurate information about the token they wish to add. This includes the token address, symbol, name, and decimals. These details can usually be obtained from the project team or verified explorers like Solscan or Solana FM. It's crucial to ensure that the token address is correct to avoid accidental transfers to invalid addresses.

Preparing Your Phantom Wallet for Token Addition

Before adding a custom token, ensure that your Phantom wallet is updated to the latest version. Open the wallet extension in your browser or launch the mobile app, and verify you're logged into the correct wallet address. If you're using the browser extension, make sure you're on the official Phantom website to avoid phishing attempts.

Next, locate the tokens tab within the wallet interface. In this section, you’ll find an option labeled “Add Token” or similar, depending on the version of the wallet. Clicking this will open a new window where you can either search for existing tokens or manually input details for a custom token. If the token isn't listed in the search results, selecting the manual entry option becomes necessary.

Manually Entering a Custom Token Address

Once you’ve chosen to manually add a token, you’ll be prompted to enter several key pieces of information:

• Token Address: The unique public key of the SPL token mint.
• Symbol: Usually a 3–5 letter abbreviation (e.g., USDC, SRM).
• Name: Full name of the token.
• Decimals: Number representing how divisible the token is (e.g., 6 for USDC).

Entering the token address correctly is the most critical step. Even a single incorrect character can result in funds being sent to an unrecoverable address. Always double-check the token address against trusted sources like Solscan or the project’s official documentation.

Verifying the Token Information Before Finalizing

After entering all the required fields, Phantom will attempt to fetch additional data associated with the token address. If the address is valid, the wallet should display a preview of the token with the symbol and name you entered. At this stage, cross-reference the displayed information with the original source to confirm accuracy.

If everything matches, click the “Add Token” button to finalize the process. The token should now appear under your token list within the Phantom wallet. You’ll be able to see your balance if you already hold some of this token, and you'll also be able to send or receive it through the wallet interface.

It's important to note that even after successfully adding a token, Phantom does not guarantee its legitimacy or functionality. Users remain responsible for verifying the authenticity and safety of the tokens they interact with.

Recovering Funds Sent to an Incorrectly Added Token

If you mistakenly added a token with an incorrect address and accidentally sent funds to it, recovery options are extremely limited. Since Solana transactions are irreversible, there is no way to retrieve tokens sent to an invalid or incorrect token address unless the recipient controls the private keys and is willing to return them.

To prevent such situations, always test with a small amount before sending large quantities of tokens to a newly added custom token address. Additionally, store the correct token address securely once verified, and avoid re-entering it unless absolutely necessary.

Frequently Asked Questions (FAQ)

Q: Can I remove a custom token from my Phantom wallet?

Yes, you can hide a custom token from your wallet view. Go to the token details page and select the "Hide" option. Note that hiding the token doesn’t delete it permanently—you can unhide it later if needed.

Q: Why don’t I see my custom token after adding it?

Ensure that your wallet actually holds a balance of that token. If no funds are present, the token might not appear immediately. Also, check whether the network selected in Phantom is the same as the one the token resides on (e.g., mainnet-beta).

Q: What happens if I add a duplicate token with a different address?

Adding a token with a different address will create a separate entry in your wallet. This can cause confusion and potential loss of funds if you send tokens to the wrong address. Always ensure only one valid instance of a token is visible.

Q: Is it safe to add tokens from unknown sources?

No. Only add tokens from trusted and verified sources. Malicious actors sometimes create fake tokens to trick users into sending funds. Always verify the token address and contract integrity before interacting.