Creators can update token metadata directly in The Lab for most newer contracts. Updates include title, description, thumbnail, main media, and traits or attributes. A small gas fee applies.
Important dates and contract types
Synergy deprecated on March 23, 2025.
Contracts deployed before this date use Synergy. Self-service metadata updates in The Lab are not available for these. Please read the Synergy FAQ and contact support for help.
Contracts deployed after this date support self-service metadata updates.
Multi-Creations contracts do not support metadata updates. Only 1/1s (ERC-721) and Editions (ERC-1155) are supported.
What you can change
Title
Description
Thumbnail
Main media file
Traits and attributes
Drafts vs minted tokens
Draft tokens: Update them before you mint.
Tokens on a Mint Page: If the token is still a draft on a published Mint Page, delete the Mint Page, update your draft, then create a new Mint Page.
Minted tokens: Follow the steps below.
Step-by-step: Update metadata for a minted token
Open your Collection Dashboard in The Lab.
Hover over the token you want to update.
Click the pencil icon labeled “Update metadata.”
You will land on the token creation page. Edit the title, description, media, thumbnail, and attributes as needed.
Click “Preview and update metadata.”
Review the details, then click “Update metadata.”
In the wallet modal, click “Update onchain” and confirm the transaction.
Wait for confirmation. That is it.
Note: A small gas fee applies per update. Network confirmation times can vary.
After you update
The Lab will reflect changes as soon as the transaction confirms.
Marketplaces and indexers may take a short time to refresh. If something looks stale, wait a few minutes and refresh the page.
Common questions
Why can’t I see the “Update metadata” option?
You are likely on a contract that was deployed before March 23, 2025 or you are viewing a Multi-Creations token.Do I pay gas every time I update?
Yes. Each update is an onchain action.Can I revert to a previous version?
Upload the earlier media and set the prior text again, then submit a new update. Version rollback is not automatic.Will changing media affect existing collectors?
Collectors will only see the updated metadata once indexers refresh.
Need help?
Working on a pre-March 23, 2025 Synergy contract? Read the Synergy FAQ and then contact us.
Something not updating as expected? Please share the contract address and token ID with support so we can check the indexer status.