ES

Token Metadata

MetadataV1 account — links a mint to its name, symbol, URI, royalties, creators, and optional collection. The foundation of every Solana NFT.

Metaplex Token Metadata 607 bytes

Sample: Mad Lads

(cached; refreshes hourly · mainnet only)

Key Update Authority Mint Name Length Name Symbol Length Symbol URI Length URI Seller Fee Creators Creators Count Creator #1 Creator #2 Primary Sale Happened Is Mutable Edition Nonce Token Standard Collection Uses Collection Details / Programmable Config
0 1 2 3 4 5 6 7 8 9 A B C D E F
0000 04 15 3b 99 08 f3 7c 3b e2 70 a4 70 1c 9f cf 24
0010 32 fd 5a b6 95 08 1f 6f 30 4c 37 33 eb 7d 07 47
0020 69 e1 37 53 3d dd db 1b 18 14 45 f3 f0 ca 26 fc
0030 d4 9e e9 d0 6e 9b 52 c0 1c c9 20 48 a1 1a c2 1e
0040 85 20 00 00 00 4d 61 64 20 4c 61 64 73 20 23 37
0050 32 36 36 00 00 00 00 00 00 00 00 00 00 00 00 00
0060 00 00 00 00 00 0a 00 00 00 4d 41 44 00 00 00 00
0070 00 00 00 c8 00 00 00 68 74 74 70 73 3a 2f 2f 6d
0080 61 64 6c 61 64 73 2e 73 33 2e 75 73 2d 77 65 73
0090 74 2d 32 2e 61 6d 61 7a 6f 6e 61 77 73 2e 63 6f
00a0 6d 2f 6a 73 6f 6e 2f 37 32 36 36 2e 6a 73 6f 6e
00b0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00c0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00d0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0120 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0130 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 a4
0140 01 01 02 00 00 00 43 5a e4 60 4a 54 61 38 c2 c9
0150 49 32 f2 b9 73 3e 83 8b 45 34 dc aa 86 c1 38 59
0160 d5 8d 1b 89 45 01 01 00 15 3b 99 08 f3 7c 3b e2
0170 70 a4 70 1c 9f cf 24 32 fd 5a b6 95 08 1f 6f 30
0180 4c 37 33 eb 7d 07 47 69 01 64 01 01 01 ff 01 04
0190 01 01 fc b3 1b 4f f9 e6 68 7b eb 35 cb 7c 5d ab
01a0 19 d3 2d 67 a6 8e 57 62 4e cb c3 0f b3 ac 1c 5c
01b0 08 5e 00 00 01 00 01 09 86 22 85 e3 71 0a 90 d5
01c0 1d 9e 47 02 de 9a 9d d5 e9 fd c8 ac 81 d2 d2 ac
01d0 d1 e1 dd c8 24 fe c4 00 00 00 00 00 00 00 00 00
01e0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
01f0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0200 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0210 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0220 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0230 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0240 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0250 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
View full hex

What it is

A Metaplex Token Metadata account attaches a name, symbol, image URI, and creator royalties to an SPL Mint — the foundation of every Solana NFT and most fungible-with-metadata tokens.

Why it exists

SPL Mint accounts are just numbers: supply, decimals, authorities. For NFTs you need a name, a picture, creators to pay royalties to, and a way to point to off-chain JSON. Metaplex’s Token Metadata program stores that on-chain as a separate account derived from the mint via a fixed PDA: ["metadata", program_id, mint_pubkey].

Byte layout

The 607-byte MetadataV1 layout is dominated by three padded variable-length strings and several Option fields. Padding is zero-byte filled to fixed maxima.

Offset Length Field Type Notes
0 1 key u8 enum 4 = MetadataV1.
1 32 update_authority Pubkey Can update fields while is_mutable.
33 32 mint Pubkey The SPL Mint this metadata describes.
65 36 name padded string 4-byte length + up to 32 bytes UTF-8.
101 14 symbol padded string 4-byte length + up to 10 bytes UTF-8.
115 204 uri padded string 4-byte length + up to 200 bytes UTF-8. Points at off-chain JSON.
319 2 seller_fee_basis_points u16 LE Royalty in basis points (500 = 5%).
321 var creators Option<Vec<Creator>> 1-byte Option tag + 4-byte length + 34-byte Creator entries.
… 1 primary_sale_happened bool  
… 1 is_mutable bool If false, fields are frozen forever.
… 2 edition_nonce Option<u8> 1-byte Option tag + 1-byte nonce.
… 2 token_standard Option<u8> enum NonFungible, Fungible, ProgrammableNonFungible, etc.
… var collection Option<Collection> Linked collection mint.
… var uses Option<Uses> Burn/multi/single use tracking.

Total: 607 bytes (padded to fixed size; variable fields fill to maximum).

Where you see it

Wallets and marketplaces resolve any NFT mint to its Token Metadata account to render the name and image. Most fungible tokens use Metaplex too (USDC’s logo and name come from a Metadata account). Token-2022 introduced an alternative inline metadata extension that avoids the separate account, but Metaplex remains dominant for NFTs.

Common gotchas

  • Padded strings, not Borsh-style. name/symbol/uri are length-prefixed but always padded to maximum size on-chain. The trailing zero bytes are part of the layout.
  • is_mutable: false is permanent. Once set, no field can be changed. Many collections immutabilize after mint-out to prove provenance.
  • Metaplex uses Borsh Option (1-byte tag), not SPL’s COption (4-byte tag). The two encodings live side-by-side on Solana — easy source of off-by-3 bugs.
  • Royalties are advisory. On-chain seller_fee_basis_points doesn’t force marketplaces to pay — pNFTs (Programmable NFTs) added enforcement via a separate ruleset.

Sources

See also

Last verified: 2026-05-19

Back to Learn Try the Byte Challenge