> For the complete documentation index, see [llms.txt](https://blockchainjoshs-organization.gitbook.io/basics-of-nfts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://blockchainjoshs-organization.gitbook.io/basics-of-nfts/nft-metadata.md).

# NFT Metadata

**What  are Metadata** :man\_technologist:

On a blockchain where data are stored, and can be used to identify data stored. an NFT method of identity is the metadata which contain its information.

The metadata includes two main parts: data stored on-chain in the PDA (program Derived address)  and data stored off-chain (usually in some permanent decentralized storage, e.g., Arweave, IPFS, or Shadow Drive).&#x20;

PDA for better understanding, look at it as a storage room to keep all your stuff at :thumbsup:

On-Chain Metadata​

The following fields are data stored within the on-chain metadata PDA for a given NFT:

***Key*** - An account discriminator that identifies the type of metadata account

***Update Authority*** - The public key that is allowed to update this account

***Mint*** - The public key of the Mint Account it derives from

*Name* - The on-chain name of the token (e.g., <mark style="color:green;">"Quick Pixel #1"</mark>)

***Symbol*** - The on-chain symbol of the token (e.g., <mark style="color:green;">"FFF"</mark>)

***Uri*** - The URI to the external metadata. This URI points to an off-chain JSON file that contains additional data following a certain standard

***Seller Fee Basis Points*** - This is the royalties the creators get for creating the NFTs when you buy them

***Primary Sale Happened*** - A boolean indicating if the token has already been sold at least once. Once flipped to True, it cannot ever be False again. This field can affect the way royalties are distributed

***Is Mutable*** - A boolean indicating if the metadata account can be updated. Once flipped to False, it cannot ever be True again

***Creators*** - (optional) An array of creators and their share of the royalties. This array is limited to 5 creators. Each creator object contains the following fields: Address (string of creator's public key), Verified (boolean--true if the creator has signed the NFT), Share (a number \[0-100] representing the proportional share of royalties in %. Sum of all creators' share should be 100)

***Additional optional fields include***: Creators, Edition Nonce, Token Standard, Collection, Uses, Collection Details

Source: Metaplex Token Metadata Accounts

<figure><img src="https://4246945146-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fribi2E3XCLQ9L7N8tAq8%2Fuploads%2FxYAwjpvMTXxRh7d4jxv5%2Fmetadata2.png?alt=media&amp;token=dc65f9ac-bf09-49ee-9d44-82579af2897f" alt=""><figcaption><p> JSON file containing details of an NFT image</p></figcaption></figure>
