Token metadata contains the public information that helps wallets, explorers and users understand what a token represents.
The blockchain mint itself primarily handles token mechanics. Metadata adds the human-readable identity around it.
What can metadata contain?
Depending on the token standard and metadata configuration, it can include information such as:
- Token name.
- Symbol or ticker.
- Description.
- Image.
- Website.
- Social links.
- A URI pointing to additional metadata.
This is why a token can have a recognizable logo and project information instead of appearing only as a mint address.
Where is the information stored?
Not every piece of information has to be stored directly inside the blockchain transaction.
A token can contain a metadata URI that points to a JSON document containing additional information.
Images and JSON metadata are commonly stored using decentralized or distributed storage systems such as IPFS.
Why does metadata matter?
Good metadata helps users identify the token they are looking at.
Incorrect, broken or missing metadata can cause problems such as:
- Missing images.
- Incorrect token names.
- Broken descriptions.
- Invalid links.
- Poor presentation in compatible wallets or explorers.
What is mutable metadata?
If metadata is mutable, the authorized update authority may still be able to change supported metadata fields.
This can be useful while a project is being prepared or maintained.
However, it also means the metadata is not permanently locked.
What is immutable metadata?
When supported metadata is made immutable, future updates are prevented.
That can provide stronger permanence, but it also means mistakes may become impossible to correct.
Always verify the name, image, symbol, description and links before making metadata immutable.
ForgeMyToken Review and Fix tools can help inspect supported token metadata and identify configuration details before you make permanent changes.