Update Sui Coin Metadata

The 20lab Sui update metadata tool lets you modify the on-chain metadata of a Sui coin - name, symbol, image, and description - through a single interface. It works with any token using Sui's standard Coin module and stores the updated metadata directly on-chain.

Metadata changes are how you update what wallets, explorers, DEXes, and trackers display for your token. The tool handles IPFS uploads for images and on-chain metadata updates automatically - no need to host your own files or interact with Move contracts manually. Hands-on walkthrough: how to change Sui token metadata.

The tool supports updating all standard metadata fields on a Sui coin:

• Name - The full name displayed in wallets and explorers
• Symbol - The short ticker (SUI, USDC, etc.)
• Image - Token logo shown in wallets and aggregators
• Description - Short summary of your project

20lab pins images to IPFS automatically and updates the on-chain metadata in a single transaction, so changes propagate to all major Sui wallets and explorers without manual hosting.

To change your Sui token name, symbol, or logo:

1. Connect the wallet holding the treasury cap and metadata cap
2. Enter your token's coin type or address
3. Edit any combination of name, symbol, logo, or description
4. Confirm the transaction

20lab uploads the new image to IPFS and updates the on-chain metadata in a single step. Most Sui wallets and explorers refresh within minutes, faster than equivalent updates on Ethereum or Solana thanks to Sui's object-centric architecture. For deeper background on how metadata is structured, see our custom token metadata on Sui guide.

For Sui coins, the wallet that holds both the treasury cap and metadata cap can update metadata. This is typically:

• The wallet that originally deployed the token
• Any wallet the caps have been transferred to
• A multisig wallet if the caps were assigned to one

If the treasury cap or metadata cap has been revoked, the metadata becomes permanently immutable. The tool checks the connected wallet's caps before allowing updates, so you never waste gas on a failed transaction.

Sui coin metadata is stored differently from Ethereum and Solana. The Move Coin module stores metadata as a separate on-chain object linked to your coin type.

Key properties:

• Metadata lives directly on-chain, not just as a URI pointer
• The image URL points to off-chain storage (typically IPFS via 20lab)
• Updates require holding the appropriate cap
• Sui's object-centric model means metadata updates propagate quickly across the network

This design makes Sui metadata more directly readable than systems that depend on off-chain JSON resolution. Tokens deployed with the 20lab Sui token generator follow this exact pattern.

Sui metadata changes propagate quickly thanks to the object-centric model:

• On-chain data - Updated immediately when the transaction finalizes
• Sui Explorer and Suiscan - Within seconds to minutes
• Sui Wallet, Suiet, Slush, and other wallets - Minutes to a few hours depending on cache settings
• DexScreener, Birdeye, CoinGecko on-chain - Hours to a day, sometimes requires a manual refresh request
• Centralized exchanges - Manual update required from their teams

If a platform doesn't refresh, most have a "request token info update" form you can submit.

No - metadata updates are purely cosmetic. Changing the name, symbol, image, or description does not affect:

• Coin balances or holder addresses
• Total supply or decimals
• Treasury cap or deny cap functionality
• Existing liquidity pools or DEX listings (though they may need to refresh the display)
• Programs or contracts integrated with your coin

The coin type - the immutable identifier of your token - never changes, even if name and symbol do. Anything on-chain that references your coin by type continues working without interruption.

Yes - to make your Sui coin metadata permanently immutable, revoke the treasury cap or metadata cap using the revoke authority tool. Once revoked:

• No one can ever change the name, symbol, image, or description
• The coin's identity is cryptographically locked
• This is irreversible

Many projects revoke treasury cap after their final rebrand to signal that the token's identity is finalized. This is a standard part of "renouncing" a Sui coin alongside revoking deny cap and upgrade cap. Full walkthrough: how to revoke metadata cap on Sui.

The tool works with any Sui coin built on the standard Move Coin module, including coins created with the 20lab Sui token generator (standard and regulated)

The tool cannot update:

• Coins where the treasury cap or metadata cap has been revoked (metadata is permanently locked)
• Coins where the connected wallet doesn't hold the required caps
• Coins built on custom Move modules that don't follow the standard Coin pattern