Skip to main content

Verify Your Token Globally

After your token graduates, you’ll want it to appear correctly across Cardano’s ecosystem — explorers, portfolio trackers, wallets, and DEX interfaces. This requires submitting your token’s metadata to the Cardano Token Registry.

What is the Cardano Token Registry?

The Cardano Token Registry is a public GitHub repository maintained by the Cardano Foundation. It maps token policy IDs to human-readable metadata like name, ticker, logo, and description. Once your token is listed, tools like Eternl, Lace, Taptools, and CardanoScan will display your token’s name and logo instead of a raw policy ID.

How to submit your token

1

Gather your token details

You’ll need:
  • Your token’s policy ID
  • Token name (as registered on-chain)
  • Ticker
  • Description (max 500 characters)
  • Logo (PNG, base64 encoded, recommended 250x250px)
  • Your token’s URL (website or social)
2

Fork the registry

3

Create your entry

In the mappings/ folder, create a new JSON file named after your policy ID + asset name hex. Follow the format of existing entries in the folder.
4

Sign the submission

You’ll need to sign the entry with your token’s policy signing key to prove ownership. Instructions are in the registry’s README.
5

Open a pull request

Submit your changes as a pull request to the main repository. The Cardano Foundation reviews submissions — approval typically takes a few days to a week.
You’ll need basic familiarity with GitHub to complete this process. If you’re not comfortable with Git, ask a community member or developer for help.

After approval

Once your PR is merged, most Cardano tools update automatically within 24–48 hours. Your token will display its name, ticker, and logo across wallets and explorers.