Asset Metadata | Algorand Developer Portal

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

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

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

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

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:

These conventions support consistency across tools and applications.

Choosing a metadata approach

The right metadata approach depends on the needs of your application.

Following established conventions makes it easier for other applications in the Algorand ecosystem to understand and display your assets.

Learn more

Asset Parameters Reference View the full list of parameters used when creating and configuring ASAs.

Algorand Standard Assets Overview Learn how ASAs work and how they are configured.