NFT Glossary
What is tokenURI?
tokenURI is the metadata pointer an NFT contract exposes for a specific token. It usually resolves to a JSON file describing the NFT name, description, image, attributes, and sometimes animation or external links.
In practice, tokenURI is the bridge between a smart contract and the media experience collectors see on marketplaces. When OpenSea, Blur, or another app loads an NFT, it often reads tokenURI first.
The returned metadata can live on IPFS, Arweave, HTTPS, or even inside an on-chain data URI. That means tokenURI is not the artwork itself. It is the route that helps software find and interpret the artwork.
Why it matters
- It controls how marketplaces display your NFT.
- It defines where metadata and media are loaded from.
- It determines whether metadata updates or freezes are possible, depending on your contract design.
Common tokenURI formats
https://...URLsipfs://...URIsar://...URIsdata:application/json;base64,...on-chain metadata
Relevant tools
- TokenURI Tester to resolve and validate metadata URLs.
- NFT Metadata Generator to build JSON that a tokenURI can serve.
- IPFS vs Arweave for NFT Metadata for storage decisions.