Update Compressed NFT | Metaplex CLI

The mplx bg nft update command updates the off-chain metadata of a compressed NFT. You can update individual fields or use the interactive editor to modify the full metadata JSON.

Basic Usage

Update Individual Fields

mplx bg nft update <assetId> --name "New Name"

Update Multiple Fields

mplx bg nft update <assetId> --name "New Name" --description "New Description" --image ./new-image.png

Interactive Editor

mplx bg nft update <assetId> --editor

Arguments

Argument	Description
`ASSET_ID`	The compressed NFT asset ID to update

Options

Option	Description
`--name <value>`	New name for the NFT
`--symbol <value>`	New symbol for the NFT
`--description <value>`	New description for the NFT
`--image <value>`	Path to new image file
`--uri <value>`	New metadata URI (alternative to updating fields)
`-e, --editor`	Open metadata JSON in your default editor

Global Flags

Flag	Description
`-c, --config <value>`	Path to config file. Default is `~/.config/mplx/config.json`
`-k, --keypair <value>`	Path to keypair file or ledger (e.g., `usb://ledger?key=0`)
`-r, --rpc <value>`	RPC URL for the cluster
`--json`	Format output as JSON

Examples

Update the name:

mplx bg nft update CNFTAssetIdHere --name "Updated NFT Name"

Update name and description:

mplx bg nft update CNFTAssetIdHere \
  --name "New Name" \
  --description "This NFT has been updated"

Update with new image:

mplx bg nft update CNFTAssetIdHere \
  --name "Refreshed NFT" \
  --image ./new-artwork.png

Replace entire metadata URI:

mplx bg nft update CNFTAssetIdHere --uri "https://arweave.net/xxx"

Use interactive editor:

mplx bg nft update CNFTAssetIdHere --editor

Output

--------------------------------

  Compressed NFT Update

--------------------------------
Fetching asset and proof data... ✓
Uploading Image... ✓
Uploading JSON file... ✓
Updating compressed NFT... ✓

--------------------------------
  Compressed NFT: Updated NFT Name
  Asset ID: CNFTAssetIdHere
  Signature: 5xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  Explorer: https://solscan.io/tx/5xxx...
--------------------------------

Authority Requirements

To update a compressed NFT, you must be either:

Tree Authority - If the NFT is not in a collection
Collection Update Authority - If the NFT belongs to a Metaplex Core collection

Notes

The RPC must support DAS API
If updating fields (not URI), the existing metadata is fetched and merged with your changes
If metadata fetch fails, you must provide all fields to create new metadata
The --uri flag is mutually exclusive with --image, --description, and --editor
The --editor flag is mutually exclusive with all other update flags
Editor uses $EDITOR environment variable, or defaults to nano/notepad