What is Metaplex Token Metadata? Plain English (2026)
Metaplex is the on-chain program that gives Solana SPL tokens their name, symbol, image, and links. Plain-English explanation of how it works.
Metaplex Token Metadata is a Solana on-chain program that stores the human-readable identity of an SPL token — name, symbol, image URI, description, and social links — in a separate metadata account linked to the token's mint address. The SPL Token Program itself only stores supply, decimals, mint authority, and freeze authority; without Metaplex, a token has no name or logo and shows up as "Unknown Token" in wallets. The metadata account costs about 0.0144 SOL of rent at creation and has its own update authority, separate from mint and freeze authorities. Reputable creator tools bundle Metaplex metadata creation into the same transaction as the token mint, so the token has a name and image from the first second it exists.
When you see "BONK" on Solscan with a logo and Twitter link, none of that comes from the SPL Token Program — the SPL Token Program literally has no field for "name." All of it lives in a second on-chain program called Metaplex, attached to the token mint via a separate account. Knowing the split matters because most "missing token name" or "broken image" problems we see are people fixing the wrong program. Below is what each program owns and why creator tools always bundle both together in a single transaction.
The two-program architecture
Solana's token system is split across two on-chain programs:
| Program | What it stores |
|---|---|
| SPL Token Program | Supply, decimals, mint authority, freeze authority |
| Metaplex Token Metadata Program | Name, symbol, image URI, description, social links, update authority |
Each token has both:
- A mint account (in the SPL Token Program) — the technical identity
- A metadata account (in Metaplex) — the human identity
These two accounts are linked: the metadata account stores the mint address it describes, and tools like Solscan look up both when displaying a token.
Why two programs instead of one? Solana's design encourages composability through separate, focused programs. The SPL Token Program is minimal and battle-tested; Metaplex evolved separately to handle the richer requirements of NFTs and metadata, and the same standard naturally applied to fungible tokens.
What's actually in a metadata account
The Metaplex metadata account stores a structured set of fields:
- name — display name (e.g., "Bonk")
- symbol — ticker (e.g., "BONK")
- uri — link to off-chain JSON with full metadata (image, description, attributes, social links)
- sellerFeeBasisPoints — for NFTs, the royalty rate (irrelevant for fungible tokens)
- creators — list of wallet addresses with optional verified flag (used in NFT royalty splits)
- isMutable — boolean: can the metadata still be updated?
- updateAuthority — wallet address allowed to modify the metadata
The on-chain part is small — name, symbol, URI, plus pointers. The full metadata (image, description, links) lives off-chain at the URI, typically on IPFS or Arweave.
The off-chain JSON
When you click a Solana token on Solscan and see its image and description, here's what's happening:
- Solscan reads the metadata account from Metaplex
- It pulls the
urifield, which points to a JSON file (e.g.,https://cf-ipfs.com/ipfs/bafy...) - It fetches that JSON, which looks like:
{
"name": "Bonk",
"symbol": "BONK",
"description": "The first Solana dog coin for the people, by the people",
"image": "https://arweave.net/hash-to-image",
"extensions": {
"twitter": "https://twitter.com/bonk_inu",
"telegram": "https://t.me/bonkonsolana",
"website": "https://bonkcoin.com"
}
}
- Solscan renders the image and links
Implication: if the IPFS gateway is slow or the image host goes down, your token displays without an image. This is why projects pin metadata to persistent storage (Arweave is permanent, IPFS via Pinata or Cloudflare gateways is reliable).
Update authority — the third token authority
When you launch a Solana token via Alchemii or any creator tool, you'll see three "revoke" toggles:
- Mint authority (guide) — controlled by SPL Token Program
- Freeze authority (guide) — controlled by SPL Token Program
- Update authority — controlled by Metaplex Token Metadata Program
Update authority is the wallet that can:
- Change the token's name, symbol, or image URI
- Mark the metadata as mutable or immutable
- Transfer update authority to another wallet
- Revoke update authority (set it to
null)
If update authority is active, the holder can rename your token — for example, changing "BONK" to "STOLEN_BONK_v2" or repointing the image URI to a malicious image. This is why some projects revoke update authority after their branding is final.
But unlike mint/freeze authority, update authority has legitimate ongoing uses:
- Fixing a typo in the description
- Updating the image to a higher-resolution version
- Adding a Twitter handle that didn't exist at launch
- Migrating image hosting from cheap IPFS to permanent Arweave
So the right strategy depends on your token type:
| Token type | Update authority |
|---|---|
| Memecoin (final branding at launch) | Revoke after launch + final QA |
| Project token (may need updates) | Keep active, on a multisig |
| Stablecoin / regulated asset | Keep active for compliance updates |
| NFT collection | Required for some collection-level operations |
How isMutable interacts with update authority
The isMutable flag is a separate gate. Even if update authority is active, the metadata can't be changed if isMutable: false.
isMutable | Update auth active | Can metadata change? |
|---|---|---|
| true | yes | yes |
| true | revoked (null) | no (no one to authorize) |
| false | yes | no (locked even with active auth) |
| false | revoked (null) | no (double-locked) |
For maximum trust signal: set isMutable: false AND revoke update authority. This means "no one, including the original creator, can ever change this token's metadata."
Why Metaplex matters for memecoin launches
Some less-known token creator tools mint the SPL token but skip Metaplex metadata creation. The result: your token has supply and decimals on-chain, but no name, symbol, or image. Solscan shows it as Unknown Token with the raw mint address.
This is bad for adoption because:
- Buyers don't see a recognizable token in their wallet
- Aggregators like Jupiter need metadata to display the token in swap UIs
- DexScreener can't render a logo on the pair page
- Centralized exchanges won't list a token without metadata
Reputable creators (including Alchemii) bundle Metaplex metadata creation into the token mint transaction, so your token has all three account types — mint account + metadata account + token account — created in one click.
Metaplex metadata stats across the Solana ecosystem
How prevalent is Metaplex metadata, and what happens to tokens that ship without it?
Toggle: hosting choice for your token's image
How to update Metaplex metadata after launch
If your update authority is still active, you can update metadata via:
- The official Metaplex CLI:
npx @metaplex-foundation/sugar(originally for NFTs, also works for fungible tokens) - Programmatically with @metaplex-foundation/mpl-token-metadata
- Via wallet UIs — Phantom and Solflare expose a basic update flow for tokens you own
The transaction calls Metaplex's UpdateMetadataAccountV2 instruction. Costs are minimal (~0.001 SOL).
Common questions
Does Metaplex add to the cost of creating a token? Yes — the metadata account requires ~0.0144 SOL of rent (one-time, returned if you ever close the account). It's already factored into our cost breakdown.
Where should I host my image? Best to worst:
- Arweave — permanent, paid once, reliable
- IPFS via Pinata or Cloudflare — reliable but you pay for pinning
- IPFS via free public gateways — works but slow and unreliable
- Direct HTTPS hosting — works but if your domain expires, the image breaks
For memecoin launches, Pinata IPFS is a good cost/quality balance.
Can a token have multiple metadata accounts? No — there's exactly one metadata account per mint, derived deterministically from the mint address.
What happens if my image URI breaks? The token still works on-chain (transfers, swaps, etc.), but Solscan/wallets show a broken image placeholder. You can fix it by updating the URI if your update authority is still active.
Are NFTs and fungible tokens both Metaplex?
Yes. Both use the Token Metadata Program. The difference is the tokenStandard field: NFTs are NonFungible or ProgrammableNonFungible, memecoins are Fungible.
Why doesn't the SPL Token Program just include metadata? Solana's design philosophy keeps programs minimal and composable. SPL Token handles fungibility/balances; Metaplex handles metadata. Same reason Linux has separate utilities for "list files" vs "edit files" instead of one mega-tool.
Quick facts (verifiable specifications)
| Specification | Value | Source |
|---|---|---|
| Metaplex Token Metadata Program ID | metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s | Metaplex Token Metadata Program |
| SPL Token Program ID | TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA | Solana SPL Token Program |
| Metadata account rent | ~0.0144 SOL (one-time, refundable on close) | Article body |
| Metadata update transaction cost | ~0.001 SOL | Article body |
| Update instruction | UpdateMetadataAccountV2 | Metaplex docs |
| Metadata accounts per mint | Exactly one (deterministic PDA from mint address) | Metaplex design |
| Token standard for fungible tokens | Fungible | Metaplex Token Standard |
| Token standard for NFTs | NonFungible or ProgrammableNonFungible | Metaplex Token Standard |
| On-chain fields | name, symbol, uri, sellerFeeBasisPoints, creators, isMutable, updateAuthority | Article body |
| Off-chain JSON location | URI in metadata account (typically IPFS or Arweave) | Article body |
| Maximum-trust lock | isMutable: false AND update authority null | Article body |
Limitations of this guide (what it doesn't cover)
This article covers the Metaplex Token Metadata program for fungible SPL tokens. Several adjacent topics are intentionally out of scope.
- NFT-specific Metaplex features. Royalty enforcement, collection verification, programmable NFTs (pNFTs), Candy Machine, and Bubblegum compressed NFTs are NFT-focused and not covered here. The official Metaplex docs are the right reference.
- Token-2022 native metadata extension. Token-2022 has its own metadata extension that doesn't use Metaplex at all. See SPL Token vs Token-2022 for that comparison.
- Self-hosted metadata server / signed URIs. Production patterns for hosting metadata behind a CDN, rotating IPFS gateways, or using Arweave manifests are deployment topics outside this article's scope.
- Programmatic metadata creation in code. We point at
@metaplex-foundation/mpl-token-metadatabut don't walk through SDK examples — that package's own README is the right starting point. - Multi-language i18n for metadata. The Metaplex schema doesn't natively support per-locale name/description; projects that need it implement a custom layer in the off-chain JSON.
- Non-Solana chains. ERC-721/1155 metadata on Ethereum follows different conventions; this article is Solana-only.
Sources & references
- Metaplex Token Metadata docs — Metaplex FoundationAuthoritative source for the Metaplex Token Metadata standard.
- Metaplex Token Metadata source — GitHub / MetaplexOpen-source program implementing the metadata account schema.
- SPL Token Program — Solana LabsThe other half of the two-program architecture — handles supply and authorities.
- Phantom wallet — token display — PhantomHow Phantom reads Metaplex metadata to display name and image.
- Solscan token explorer — SolscanShows tokens without metadata as 'Unknown Token' — confirms the practical impact.
- Jupiter strict list — Jupiter / GitHubStrict-list inclusion requires Metaplex metadata; tokens without it cannot be verified.
- Bitquery Solana DEX & token data — BitqueryUsed to derive metadata coverage statistics across the Solana ecosystem.
- Pinata IPFS pinning — PinataReliable paid IPFS pinning service — common choice for Metaplex metadata image hosting.
- Arweave permanent storage — ArweavePay once, store forever — preferred for tokens that want to never break.
- Birdeye Solana — BirdeyePulls Metaplex metadata for token discovery and analytics.
- DexScreener — Solana — DexScreenerAggregator that displays Metaplex name + image for every token.
- BONK token metadata — SolscanReal example: full Metaplex metadata visible on the token page.
- Alchemii update metadata tool — AlchemiiNo-code tool to update Metaplex metadata on an existing token.
- @metaplex-foundation/mpl-token-metadata SDK — npm / MetaplexOfficial JavaScript SDK for programmatic metadata creation and updates.
- Solana token image not showing — debug guide — AlchemiiMost common Metaplex metadata problem — image URI fails to load.
FAQ
What is Metaplex Token Metadata?
Metaplex Token Metadata is an on-chain Solana program that stores name, symbol, image URL, and description for SPL tokens. Without Metaplex metadata, your SPL token would have no human-readable identity — wallets would just show the mint address. Metaplex is what lets Phantom display your token logo and Solscan show your token name.
Is Metaplex required for Solana tokens?
Technically no — the SPL Token Program operates without Metaplex. But practically yes: tokens without Metaplex metadata show as 'Unknown SPL Token' in every wallet, can't be listed on aggregators, and look visibly broken to users. Every real launch uses Metaplex Token Metadata to attach name, ticker, and image.
What goes in Metaplex token metadata?
On-chain fields: name, symbol, URI (link to off-chain JSON), seller_fee_basis_points, creators array, update authority. Off-chain JSON pointed to by URI: image (URL to the actual logo), description, external_url (project website), and any custom attributes. Total on-chain rent is roughly 0.0014 SOL per metadata account.
What is update authority in Metaplex?
Update authority is the wallet allowed to modify the metadata account — change name, ticker, image, description. It defaults to the creator's wallet. While update authority is active, you can fix typos, swap images, or update social links. Once revoked, the metadata becomes immutable. Memecoins typically revoke update authority to signal final, fixed branding.
Where should I host the image my Metaplex metadata points to?
IPFS via NFT.Storage, Pinata, or Filebase — pin services that guarantee the file stays available indefinitely. Don't use a regular web URL: if your hosting goes down, your token's image disappears across every wallet and explorer. IPFS with proper pinning is the standard, and most token-creation tools (including Alchemii) handle the pinning for you.
Launching a Solana token? Alchemii's Token Creator handles SPL Token + Metaplex metadata in a single transaction — no need to call them separately. If it's a memecoin, our pre-configured meme coin tool bundles the same flow with memecoin-friendly defaults. For the full launch playbook, see our Solana memecoin launch checklist.
Related Topics
More guides covering the same Solana token creation, mint authority, LP burn, Raydium liquidity, and memecoin launch topics.
Can You Edit a Solana Token After Launch? (2026)
What you can change post-launch (name, image, links), what you can't (mint, decimals), and how authority revocation locks specific changes forever.
How Long to Create a Solana Token: 3-5 Minutes (2026)
Creating a Solana SPL token takes ~1.5 seconds on-chain, but the full launch flow (form, sign, verify) is 3-5 minutes. Exact timing per phase inside.
Solana Token Image Not Showing? 5 Fixes (2026)
Token logo not appearing on Phantom, DexScreener, or Solscan? The 5 specific causes — broken IPFS gateway, wrong format, missing metadata, CDN cache.
SPL Token vs Token-2022: When to Pick Each (2026)
SPL Token vs Token-2022: differences, transfer fees, confidential transfers, when each makes sense, and which memecoins should pick (2026 guide).
What is Freeze Authority on Solana? (2026)
Freeze authority is the wallet allowed to freeze any holder's tokens on a Solana SPL token. Plain-English explanation, why it matters, and when to revoke.
What is Mint Authority on Solana? Plain English (2026)
Mint authority is the wallet that can create new Solana tokens. What it does, why it matters, and what null mint authority means.