Home/Blog/
How to Change Sui Token Metadata

How to Change Sui Token Metadata

June 24, 2025

5 min read

Blue and white graphic with a gear wheel, the words “Update Metadata” and a gradient background.

Token metadata is your project's digital identity on the blockchain - it's what users see when they interact with your token in wallets, explorers, and DeFi applications. On Sui, managing this crucial information requires specific authority permissions and the right tools to execute changes seamlessly.

Whether you're rebranding an existing project, fixing metadata errors, or updating your token's visual identity, understanding how to properly modify Sui token metadata is essential for maintaining a professional presence in the ecosystem. This comprehensive guide walks you through everything you need to know about updating Sui token metadata using 20lab's specialized token tools.

What is Sui Token Metadata?

Sui token metadata contains the core information that defines your token's public identity across the blockchain ecosystem. This includes four primary elements that shape how users perceive and interact with your token:

  1. Token Name - The complete, official name of your cryptocurrency that appears in wallets and applications. This is your token's formal identity that users will recognize and search for.
  2. Token Symbol - The abbreviated ticker symbol (typically 3-5 characters) that serves as your token's shorthand identifier. Think "SUI" for Sui or "USDC" for USD Coin.
  3. Token Description - Detailed information explaining your token's purpose, utility, and value proposition. This description helps users understand what your token does and why it matters.
  4. Token Icon - The visual representation of your token that appears as a logo or image across various platforms. A well-designed icon helps with brand recognition and professional presentation.

Unlike some blockchains where metadata changes can be complex or limited, Sui's architecture provides robust tools for metadata management while maintaining security through its capability-based authority system.

Who Can Update Sui Token Metadata?

Sui's security model requires specific authority permissions to modify token metadata. Only wallets that hold both the Metadata Cap and Treasury Cap at the same time can make changes to token information. This dual-authority requirement ensures that metadata updates are secure and authorized.

The following entities can update Sui token metadata:

  • Original Token Creator - If they retained both required capabilities after token creation
  • Authorized Wallet Holders - Any wallet that was transferred both the Metadata Cap and Treasury Cap
  • Multisig Wallets - If the capabilities were transferred to a multisignature setup for enhanced security

If you don't have access to a wallet containing both capabilities, or if these authorities have been permanently revoked, you cannot modify the token's metadata. This system prevents unauthorized changes and maintains token integrity.

Step-by-Step Guide to Updating Sui Token Metadata

Prerequisites

Before beginning the metadata update process, ensure you have:

  • Access to the wallet holding both Metadata Cap and Treasury Cap
  • Your token's complete address (also called coin type on Sui)
  • New metadata information prepared (name, symbol, description, image)
  • Some SUI for transaction fees

The Update Process

Step 1: Connect Your Authorized Wallet

Visit 20lab's Sui update metadata tool and connect the wallet that holds the required capabilities. The platform automatically detects your wallet's authorities and verifies your permission to make metadata changes.

Step 2: Enter Token Information

Input your token's address in the designated field. The system will verify the token exists and confirm your wallet has the necessary authority to proceed with updates.

Sui update metadata tool interface with added token address

Step 3: Update Metadata Fields

Modify the metadata fields as needed:

  • Name: Enter the new full name for your token
  • Symbol: Input the updated ticker symbol
  • Image: Upload or provide the URL for your new token logo
  • Description: Add or revise the token description

New metadata provided in tool interface

Step 4: Review and Confirm

Carefully review all changes before proceeding. The tool displays a summary of modifications and estimated transaction fees. Once confirmed, these changes will be permanent and immediately reflected on the blockchain.

Update metadata tool confirmation modal window

Step 5: Execute the Transaction

Approve the transaction in your connected wallet. The 20lab platform handles all technical complexities, including proper blockchain formatting and IPFS storage for images.

Transaction progress window for Sui tools

Step 6: Verify Updates

After transaction completion, verify your changes appear correctly across Sui explorers and applications. Most platforms update within minutes to hours of the blockchain change.

Name, symbol and description correctly changed after transaction was confirmed

Token Compatibility

20lab's metadata update tool works with all standard Sui tokens, including:

Fully Compatible:

  • All tokens created using 20lab's Sui token generator
  • Any Sui tokens built with the standard 0x2::Coin module
  • Tokens following Sui's standard metadata structure

Limitations:

  • Tokens where Metadata Cap and Treasury Cap have been permanently revoked
  • Tokens where you don't have access to the required authority capabilities
  • Non-standard token implementations that don't follow Sui conventions

Why Choose 20lab for Sui Metadata Management

20lab's Sui metadata tools offer several advantages that make token management more efficient and secure:

  1. Comprehensive Authority Detection - The platform automatically identifies which authorities your wallet holds, providing clear visibility into your token management capabilities without requiring technical blockchain knowledge.
  2. Streamlined User Experience - Our intuitive interface guides users through each step of the metadata update process, making complex blockchain operations accessible to creators regardless of their technical background.
  3. Multi-Authority Support - Beyond metadata updates, 20lab supports management of four Sui authority types (Treasury Cap, Metadata Cap, Upgrade Cap, and Deny Cap) from a single, unified interface.
  4. Robust Validation Systems - Built-in address validation and ownership verification prevent costly errors before transactions are submitted to the blockchain.
  5. Universal Wallet Compatibility - Seamless integration with all major Sui wallets ensures you can use your preferred wallet solution without compatibility concerns.

Conclusion

Managing Sui token metadata effectively is crucial for maintaining a professional presence in the blockchain ecosystem. With 20lab's comprehensive token tools, updating your token's name, symbol, description, and visual identity becomes a straightforward process that any creator can handle confidently.

The combination of Sui's robust authority system and 20lab's user-friendly interface ensures that metadata management is both secure and accessible. Whether you're planning a rebranding, fixing errors, or enhancing your token's presentation, these tools provide the control and flexibility needed for professional token management.

Ready to update your Sui token metadata? Visit 20lab's Sui update metadata tool to begin optimizing your token's identity today.

For questions about Sui token management and best practices, connect with our team on Telegram for expert guidance and support.

Related Posts

Continue your journey with these related blog posts.

Sui Metadata inscription on a background featuring the 20lab logo with light blue graphic elements.
Building and Managing Custom Token Metadata on Sui

Discover how to implement and customize token metadata on Sui with 20lab's comprehensive toolkit. From basic attributes to advanced metadata features.

December 06, 2024

9 min read

Blue and white graphic with a gear wheel, the words “Metadata Cap” and a gradient background.
How to Transfer or Revoke Metadata Cap on Sui

Learn how to transfer and revoke Sui Metadata Cap using 20lab's authority tools.

June 24, 2025

4 min read

Sui (SUI) cryptocurrency logo is centered on a dark background with light blue elements and abstract geometric and wave-like patterns.
Sui Token - Build Your Next-Gen Project on Sui Blockchain

Create efficient, scalable tokens on the Sui blockchain. Leverage the power of the Move language and object-centric design for your next project.

November 23, 2024

9 min read

Blue and white graphic with a gear wheel, the words “Treasury Cap” and a gradient background.
How to Transfer or Revoke Treasury Cap on Sui

Learn how to transfer and revoke Sui Treasury Cap using 20lab's Sui authority management tools.

June 24, 2025

6 min read

Graphic with the inscription “SUI” on a geometric pattern background. The whole design is in shades of orange and yellow.
Sui Coin - Token Standard for Building the Future of Digital Assets

Master Sui's token standard for creating secure and scalable digital assets. Learn more about its unique features and security measures.

November 22, 2024

5 min read

Share your feedback