Manage on-chain token metadata
Add, update, or remove on-chain metadata entries on a deployed asset from the Console after issuance.
On-chain metadata stores structured key-value entries on the token contract, such as an issuer reference, an external identifier, or a reporting category. Each entry sits alongside the asset and any integration can read it. Use this page when you need to keep those entries current from the Console after the asset deploys.
The asset deployment locks some entries permanently; others stay editable. The token metadata page handles both: it lets you add or update editable entries and remove the ones that are not locked, while leaving immutable entries untouched.
Use this page for the web console workflow. Integrations can use the token metadata API, which exposes the same add, update, and remove operations.
Prerequisites
- A deployed asset and its token metadata page.
- The token-level governance permission for metadata changes on that asset. Without it, the page is read-only.
- Wallet verification for the transaction-submitting wallet when the active authentication flow requires it.
- The metadata key you want to change is editable. The token contract blocks updates and removals on locked (immutable) entries after deployment.
Open the token metadata page
The metadata capability tile on the asset overview is the entry point. The tile shows the entry count and a short preview of existing entries, with a footer link that opens the full metadata page.
The metadata page opens as a full detail view at /token/{assetClassSlug}/{templateSlug}/{tokenAddress}/metadata, with its own breadcrumb instead of the workspace tab row. The page lists every entry with its key, value, and lock status. For background on where the tile sits in the workspace, see the asset detail workspace.
Choose the right operation
| Goal | Operation on the metadata page | Use when |
|---|---|---|
| Record a new metadata fact | Add metadata entry | The key does not exist yet on the token. |
| Change an existing editable value | Add metadata entry | The key already exists and is editable. Reusing the same key overwrites its value. |
| Clear an editable entry | Remove entry | You no longer need an editable key on the token. |
Add or update an entry
- On the metadata page, choose Add metadata entry.
- Enter the Key and the Value. Keys are issuer-defined strings; keep keys to 200 characters or fewer so the entry stays removable later. The contract stores values as text.
- Continue to the confirmation step, complete wallet verification when prompted, and submit.
Submitting an existing key overwrites its current value, so the same form step covers both adding a new entry and editing an existing one. The platform submits the change to the token contract through the transaction queue. When the transaction completes, the updated entry appears in the table.
Remove an entry
A per-row remove control appears only for editable entries. Locked entries have no remove control.
- Find the entry in the table and choose its Remove entry control.
- Confirm the removal, complete wallet verification when prompted, and submit.
Each removal clears one key and cannot be undone. The platform submits the transaction through the queue; the entry disappears from the table once it confirms.
To illustrate: an asset team that tracks a reportingCategory entry can update it from pilot to production by reusing the same key on Add metadata entry, then confirm the new value in the table. No redeployment is needed, and every integration that reads the token's metadata sees the change immediately.
Verify the result
After a successful add, update, or remove, the metadata page reloads the entry list so the table reflects the current on-chain state. Confirm that the key shows the expected value, or that a removed key no longer appears, before treating the change as complete.
Permissions and editability
Metadata changes require the token governance permission. Operators without it see the metadata page in read-only form, with no add button and no per-row remove controls.
The instrument template sets editability at asset creation. Entries marked immutable in the template lock on the deployed token and cannot change afterwards. Unlocked entries remain editable through this page, subject to the governance permission. For how editability is configured during template design, see instrument templates.