Solana Token Metadata Explained

Token metadata is the information that describes your Solana token. It includes the name, symbol, logo, description, and other details that wallets, exchanges, and block explorers display to users.

What is Token Metadata?

Metadata is the human-readable information about your token. While the blockchain stores the technical details (supply, decimals, mint address), metadata provides the context users need to understand what your token represents.

When someone views your token in a wallet or on Solscan, they see the metadata: the name, symbol, and logo you've defined. Without proper metadata, your token appears as a long address with no identifying information.

Core Metadata Fields

Standard SPL token metadata includes several essential fields:

• Name: The full display name of your token (e.g., "Solana Pearl Token")
• Symbol: The short ticker symbol (e.g., "SPRL")
• Description: A brief explanation of what your token is and its purpose
• Logo: An image file (PNG, JPG, or WEBP) that represents your token
• Decimals: The number of decimal places (typically 9 for Solana tokens)

Extended Metadata

Beyond the basics, you can add extended metadata to provide more context:

• Creator information: Your name or brand name, plus a website
• Social links: Twitter/X, Telegram, and website URLs
• Tags: Categories or keywords that describe your token

Extended metadata helps with discoverability and builds trust. When users see creator information and social links, they can verify the token's legitimacy and connect with your community.

How Metadata is Stored

Solana token metadata can be stored in two ways:

• On-chain: Metadata stored directly on the blockchain. This is permanent but costs more in transaction fees
• Off-chain with URI: Metadata stored on a server or IPFS, referenced by a URI. This is more flexible and cost-effective

Most token creation platforms use off-chain storage with a URI pointing to a JSON file. This file contains all your metadata in a standard format that wallets and explorers can read.

Metadata Standards

The Solana ecosystem uses the Metaplex metadata standard. This ensures compatibility across wallets, exchanges, and tools. When you create a token through a reputable platform, it follows this standard automatically.

The metadata JSON file includes fields like name, symbol, description, image URI, and properties. Wallets read this file to display your token correctly. Learn more about token parameters like name, symbol, supply, and decimals that are part of your token's core configuration.

Why Metadata Matters

Proper metadata is crucial for several reasons:

• User experience: Without metadata, tokens appear as addresses, making them hard to identify
• Trust: Complete metadata with creator info and social links builds credibility
• Discoverability: Exchanges and tracking sites use metadata to categorise and list tokens
• Professionalism: Well-crafted metadata shows you've put thought into your token

Updating Metadata

Whether you can update metadata depends on your token's update authority. If you revoke the update authority during creation, metadata becomes permanent. This is generally recommended for trust, but it means you cannot change details later.

If you keep update authority, you can modify metadata later. However, this reduces trust because holders know you could change the token's identity. Learn more about authority management.

Best Practices

When creating token metadata:

• Use a clear, descriptive name that reflects your token's purpose
• Choose a symbol that's memorable and not too long (3-6 characters is ideal)
• Write a concise description that explains what your token does
• Use a high-quality logo (at least 256x256 pixels, PNG or WEBP format)
• Include creator information and social links for transparency
• Consider revoking update authority to lock metadata permanently