Getting Started

Burn an NFT

Permanently destroy an NFT and reclaim rent fees.

Burn an NFT

In the following section you can find a full code example and the parameters that you might need to change. You can learn more about burning NFTs in the Core documentation.

1import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
2import { burn } from '@metaplex-foundation/mpl-core'
3import { mplCore } from '@metaplex-foundation/mpl-core'
4import { publicKey } from '@metaplex-foundation/umi'
5
6const umi = createUmi('https://api.devnet.solana.com').use(mplCore())
7const assetAddress = publicKey('AssetAddressHere...')
8
9// Permanently destroy/burn an NFT asset
10const result = await burn(umi, {
11 asset: assetAddress,
12}).sendAndConfirm(umi)
13
14console.log('Asset burned successfully')

Parameters

Customize these parameters for your burn:

ParameterDescription
assetAddressThe public key of the NFT to burn

How It Works

The burn process involves three steps:

  1. Fetch the NFT - Get the NFT data using fetchAsset
  2. Execute burn - Destroy the NFT permanently
  3. Reclaim rent - Most SOL is returned to you (except ~0.00089784 SOL)

Warning: Burning is permanent and cannot be reversed. Make sure you want to destroy the NFT before proceeding.

Rent Reclamation

When you burn an NFT:

  • Most of the rent SOL is returned to the NFT owner
  • A small amount (~0.00089784 SOL) remains to prevent the account from being reopened
  • You must be the NFT owner to burn it