Solana Token Metadata: Name, Symbol, Logo, and More

Solana token metadata is the on-chain and off-chain information that gives your token its identity -- name, symbol, logo, and description. It follows the Metaplex metadata standard so wallets like Phantom and explorers like Solscan can display your token correctly. You can set metadata during creation on SolTokenCreator.io for 0.5 SOL with no coding required.

What Does Solana Token Metadata Include?

Every Solana token has metadata fields that define how it appears across the ecosystem. These fields are stored partly on-chain through a Metaplex metadata account and partly off-chain through a JSON file hosted at a URI. Here is what each field does:

• Name -- The full display name (e.g., "Awesome Meme Token"). This appears in wallet balances, DEX trading pairs, and explorer pages. Keep it under 32 characters.
• Symbol -- The short ticker for trading and price displays (e.g., "AMT"). Typically 3 to 5 uppercase letters. This is what traders see on Raydium, Jupiter, and other DEXs.
• URI -- A link to a JSON file containing extended metadata, including your logo URL, description, and additional properties. The URI is stored on-chain while the JSON it points to lives off-chain.
• Description -- A brief explanation of your token's purpose, stored in the off-chain JSON file. Wallets and aggregators display this when users view token details.
• Image -- Your token's logo, referenced in the off-chain JSON. This square image (PNG or JPG, minimum 256x256 pixels) appears in wallets, portfolio trackers, and explorers.

Additional optional fields include external URLs, social links (Twitter/X, Telegram, Discord), and custom attributes. These fields help establish legitimacy and make your token easier for communities to verify. For a full walkthrough of the token creation process including metadata setup, see our complete Solana token creation guide.

What Is the Metaplex Metadata Standard?

Metaplex is the protocol that defines how token metadata works on Solana. When you create a token with metadata, a Metaplex metadata account is created on-chain and linked to your token's mint address. This account stores the name, symbol, URI, and core fields directly on the blockchain.

The Metaplex standard ensures consistency across the entire Solana ecosystem. When Phantom displays your token's name and logo, it reads from this metadata account. When Solscan shows token details, it pulls from the same source. Without Metaplex metadata, your token appears as an unknown token with no branding -- a significant red flag for potential holders.

The off-chain JSON file referenced by the URI follows a specific schema:

{
  "name": "My Token",
  "symbol": "MTK",
  "description": "A community-driven token on Solana.",
  "image": "https://arweave.net/your-image-hash",
  "external_url": "https://mytoken.com",
  "properties": {
    "category": "currency"
  }
}

This JSON file is typically hosted on decentralized storage like Arweave or IPFS to ensure permanence. Centralized hosting introduces a single point of failure -- if the server goes down, wallets cannot load your token's logo or description. Understanding these technical details is part of avoiding common token creation mistakes.

How Do You Upload and Set Token Metadata?

Setting up metadata manually requires uploading your logo to decentralized storage, creating and hosting the JSON metadata file, and calling the Metaplex program to attach the metadata account to your mint.

The simpler approach is using the SPL Token Creator on SolTokenCreator.io, which handles every step automatically:

1. Upload your logo -- Select a square PNG or JPG image during the token creation process. The platform uploads it to permanent storage and generates the image URL.
2. Fill in your details -- Enter your token name, symbol, description, and optional social links through the form interface.
3. Create the token -- When you click create, the platform bundles everything into a single transaction: minting the token, uploading the metadata JSON, and creating the Metaplex metadata account. Token creation costs 0.5 SOL.

Your token launches with full metadata visible in wallets and explorers immediately. You can also revoke mint authority (0.1 SOL) and freeze authority (0.1 SOL) at the same time -- learn more in our revoke mint authority guide. For a full breakdown of all costs involved, check our token creation cost guide or visit our pricing page.

How Do You Update Metadata After Token Creation?

Whether you can update metadata depends on one setting: mutability. When metadata is mutable, the update authority (usually the wallet that created the token) can modify the name, symbol, URI, description, and image at any time by signing an update transaction through the Metaplex program.

Common reasons to update metadata include fixing a typo in the token name, replacing a logo with an updated design, adding social links that were not ready at launch, or updating the description to reflect new milestones. Each update requires a transaction signed by the update authority wallet.

To update metadata, you need the update authority wallet and a tool that supports Metaplex metadata updates. The on-chain transaction fee for an update is minimal -- typically under 0.01 SOL. Make sure you retain and secure the update authority wallet, because losing access means losing the ability to modify your token's metadata permanently.

What Is the Difference Between Mutable and Immutable Metadata?

Mutable metadata can be changed by the update authority at any time. Immutable metadata is permanently locked and can never be modified. This distinction has significant implications for trust and flexibility.

Mutable metadata is the default for most newly created tokens. It allows the creator to fix errors, update branding, and evolve the token's identity over time. The trade-off is that the update authority could theoretically change the token's name or logo to something misleading.

Immutable metadata is achieved by revoking the update authority or setting the metadata account to immutable. Once locked, the name, symbol, logo, and all other metadata fields are permanently fixed. Holders know that what they see is what they will always get.

For most projects, launch with mutable metadata, finalize all details, and then make metadata immutable once everything is confirmed. If you are creating a meme coin and want to signal maximum trust, making metadata immutable alongside revoking mint and freeze authorities demonstrates that the token is fully locked down. The choice between SPL and Token-2022 also affects your metadata options -- see our SPL vs Token-2022 comparison for details.

What Are the Best Practices for Token Branding?

Strong branding directly influences whether traders trust and engage with your token. Follow these guidelines:

Logo design -- Use a clean, recognizable image that works at small sizes. Wallet icons display at 32x32 or 64x64 pixels, so avoid fine details. Upload at least 256x256 pixels for clarity. Use a square aspect ratio with no transparent background.

Name and symbol -- Choose a unique name that does not impersonate existing projects. Search existing Solana tokens on Solscan or Jupiter before finalizing to avoid conflicts on DEXs. For meme coins, the name and ticker are arguably the most important branding decisions -- see our guide on creating a viral meme coin for naming strategies.

Description -- Write a concise, factual description of your token's purpose. A clear description helps aggregators categorize your token and gives potential holders quick context.

Social links -- Include your website, Twitter/X, Telegram, and Discord links in the metadata. These appear on explorers and aggregators, making it easy for users to find your community.

Storage -- Host your metadata JSON and logo on decentralized storage (Arweave or IPFS) rather than centralized servers. Tools like SolTokenCreator's token generator handle decentralized storage automatically.

Consistency -- Keep branding consistent across your metadata, website, social accounts, and marketing materials. Mismatched names or logos across platforms erode trust and confuse potential community members.

Frequently Asked Questions

Can I add metadata to a token that was created without it?

Yes. You can attach a Metaplex metadata account to an existing mint address afterward. You need the mint authority wallet and a tool that supports creating metadata accounts for existing tokens. The process involves uploading your logo and JSON file, then calling the Metaplex create metadata instruction.

What image format and size should I use for my token logo?

Use a square PNG or JPG image with a minimum resolution of 256x256 pixels. Avoid transparent backgrounds, as some wallets render transparency as black. Keep the file size under 1 MB for faster loading, and ensure the image is clear at 32x32 pixels since that is the size many wallets use.

Does updating metadata affect my token's functionality or existing holders?

No. Metadata updates only change display information like name, symbol, logo, and description. They do not affect token balances, transfer functionality, or any on-chain behavior. Existing holders will simply see the updated branding in their wallets after the change propagates.

How much does it cost to set up token metadata on Solana?

When using SolTokenCreator.io, metadata is included in the 0.5 SOL token creation fee. Revoking mint authority costs 0.1 SOL and revoking freeze authority costs 0.1 SOL. A Market ID for Raydium listing costs 2.33 SOL. Setting up metadata manually through the Metaplex CLI costs only the transaction fee (under 0.01 SOL) plus storage fees for Arweave or IPFS.

Should I make my token metadata immutable?

For maximum trust, yes -- but only after confirming all details are correct. Once metadata is immutable, you cannot fix typos, update logos, or change descriptions. Launch with mutable metadata, verify everything displays correctly, and then lock it down. If you are following our guide on how to create a Solana token, make immutability one of the final steps.

Launch Your Token with Professional Metadata Today

Your token's metadata is the first thing traders and community members see. Getting it right from the start builds trust and sets your project apart. Visit SolTokenCreator.io to create your Solana token with full Metaplex metadata in a single transaction for 0.5 SOL, with optional mint authority revocation (0.1 SOL) and freeze authority revocation (0.1 SOL). No coding, no CLI tools, no manual uploads -- just connect your wallet and launch in under five minutes. Once your token is live, check our guides on adding liquidity on Raydium and listing on Jupiter to get your token trading. Have questions? Visit our FAQ.