Asset Metadata
Asset metadata provides additional information about an Algorand Standard Asset (ASA), such as what the asset represents, where related content is stored, and how applications can retrieve richer information about it.
While the Algorand protocol defines the core parameters of an asset, applications often use metadata conventions and external storage to describe assets in more detail. This page introduces the metadata-related fields in ASAs and outlines common approaches used across the ecosystem.
Metadata fields in ASAs
Section titled “Metadata fields in ASAs”Algorand Standard Assets include several parameters that can be used to describe an asset or reference additional metadata.
| Parameter | Description |
|---|---|
AssetName | Human-readable name for the asset |
UnitName | Short ticker or symbol |
URL | Optional URL to additional information or metadata |
MetaDataHash | Optional 32-byte hash used to verify metadata |
These fields can provide enough context for simple assets such as loyalty points or application-specific tokens. However, many applications rely on richer metadata stored outside the blockchain.
Off-chain metadata
Section titled “Off-chain metadata”The ASA URL field can be used as an entry point to off-chain asset metadata or related information. That resource might be a JSON document, a website, or another external reference.
Off-chain metadata can include media, attributes, and other asset-related data depending on the application.
Wallets, explorers, and marketplaces may read this metadata to display additional information about an asset.
Working with IPFS
Section titled “Working with IPFS”IPFS is one option for storing off-chain metadata and related media files.
Because IPFS uses content-addressed storage, it allows resources to be referenced using immutable content identifiers (CIDs), which can help ensure data integrity.
Implementation details vary depending on the ARC standard or approach used.
Availability of off-chain metadata depends on how it is hosted and maintained over time.
Metadata standards for Algorand assets
Section titled “Metadata standards for Algorand assets”Several ARC standards define common patterns for working with ASA metadata. These standards help improve interoperability between wallets, marketplaces, and applications.
Some commonly referenced standards include:
- ARC-3 – Metadata conventions commonly used for NFTs
- ARC-19 – Template URLs for resolving metadata, often used with IPFS
- ARC-89 – Standardized ASA metadata registry
These conventions support consistency across tools and applications.
Choosing a metadata approach
Section titled “Choosing a metadata approach”The right metadata approach depends on the needs of your application.
- ASA fields alone may be sufficient for simple assets that do not require additional metadata.
- Off-chain metadata enables richer descriptions or media.
- ARC standards support interoperability between wallets and marketplaces.
Following established conventions makes it easier for other applications in the Algorand ecosystem to understand and display your assets.