Update Asset

Summary

The mplx core asset update command modifies an MPL Core Asset's on-chain name, URI, image, off-chain metadata, or collection membership.

• Updates metadata fields individually (--name, --uri) or from a JSON file (--offchain)
• Uploads and assigns a new image with --image
• Adds an asset to a collection, moves it between collections, or removes it from a collection
• Requires the caller to be the current update authority of the asset (or the collection's update authority for collection assets)

Basic Usage

mplx core asset update <assetId> [options]

You must provide at least one update flag. Multiple flags can be combined in a single command — for example, updating the name and adding to a collection at the same time.

Update Options

The following flags control what the mplx core asset update command modifies on the asset.

Global Flags

These flags apply to every mplx core command and configure the CLI runtime.

Update Metadata

Update the asset's name, URI, image, or off-chain metadata. The --offchain flag reads a local JSON file and syncs the on-chain name from its name field. The --image flag uploads the file and updates the image URI in the metadata.

1# Update name and URI
2mplx core asset update <assetId> --name "Updated Asset" --uri "https://example.com/metadata.json"
3
4# Update with a JSON metadata file
5mplx core asset update <assetId> --offchain ./asset/metadata.json
6
7# Update with a new image
8mplx core asset update <assetId> --image ./asset/image.jpg
9
10# Update with JSON metadata and image
11mplx core asset update <assetId> --offchain ./asset/metadata.json --image ./asset/image.jpg

Manage Collection Membership

The --collection and --remove-collection flags control which collection an asset belongs to. These flags can be used alone or combined with metadata update flags in a single transaction.

Add an Asset to a Collection

The --collection flag assigns a standalone asset to a collection. The asset's update authority changes from an address to the collection.

1# Add a standalone asset to a collection
2mplx core asset update <assetId> --collection <collectionId>
3
4# Or use the convenience alias
5mplx core collection add <collectionId> <assetId>

Output:

✔ Asset added to collection (Tx: <transactionSignature>)

Move an Asset to a Different Collection

Use the same --collection flag on an asset that already belongs to a collection. The CLI detects the existing collection and moves the asset to the new one.

1# Move an asset from its current collection to a different one
2mplx core asset update <assetId> --collection <newCollectionId>

Output:

✔ Asset moved to new collection (Tx: <transactionSignature>)

Remove an Asset from a Collection

The --remove-collection flag detaches the asset from its current collection. The asset's update authority reverts from the collection back to the signer's address.

1# Remove an asset from its current collection
2mplx core asset update <assetId> --remove-collection

Output:

✔ Asset removed from collection (Tx: <transactionSignature>)

Running --remove-collection on an asset that is not in a collection produces an error:

✖ Asset is not in a collection
  Error: Cannot remove from collection: asset does not belong to a collection

Output

After a successful metadata update, the command displays:

--------------------------------
  Asset: <assetId>
  Signature: <transactionSignature>
  Explorer: <explorerUrl>
  Core Explorer: https://core.metaplex.com/explorer/<assetId>
--------------------------------

For collection-only operations, the output is a single confirmation line:

✔ Asset added to collection (Tx: <transactionSignature>)

Use --json for structured output:

{
  "asset": "<assetId>",
  "signature": "<transactionSignature>",
  "explorer": "<explorerUrl>"
}

Quick Reference

At-a-glance command details, scope, and source location for mplx core asset update.

Notes

• You must provide at least one update flag: --name, --uri, --image, --offchain, --collection, or --remove-collection
• The --name and --uri flags cannot be used together with --offchain
• The --collection and --remove-collection flags are mutually exclusive
• When using --offchain, the JSON metadata file must contain a valid name field — the on-chain name is synced from it
• The --image flag uploads the file and updates the image URI in the metadata automatically
• Collection operations change the asset's update authority: adding to a collection sets it to the collection address; removing reverts it to the signer's wallet address
• The caller must be the update authority of the asset (or the collection's update authority for collection assets) to perform any update
• This command applies to MPL Core Assets only — for Token Metadata NFTs, use a different update instruction