How to Mint an NFT on XRPL

The first step is preparing the content you want your NFT to represent. This could be a digital artwork, photograph, music file, video clip, written work, or any other digital file.

The file itself is not stored on the XRP Ledger — the ledger stores a record that references the asset. Your file will be hosted separately, typically on IPFS or another storage system.

Consider file format, resolution, and quality carefully at this stage. Once an NFT is minted and associated with specific metadata, changing the underlying content is not straightforward.

NFT metadata is a JSON file containing structured information about your NFT. Most XRPL NFT ecosystems expect metadata following an established format that includes fields such as name, description, image URI, and attributes.

Your metadata file should be hosted on a persistent, content-addressed storage system. IPFS is widely used because content is referenced by its cryptographic hash — if the content changes, the hash changes, making tampering detectable.

The URI you include in your NFTokenMint transaction should point to this metadata file. Test that the URI resolves correctly before minting.

You need an XRP Ledger account (wallet) to issue the NFT. This account address becomes the permanent issuer of record on the ledger.

You can create an XRPL account using a compatible wallet application. The account generates a public/private key pair — the public key becomes your address, and the private key (or seed phrase) is used to sign transactions.

Store your seed phrase securely and offline. Never share it with any website, platform, or person.

XRPL accounts must maintain a minimum XRP balance to remain active — this is called the base reserve. Additional reserve is required for each ledger object the account holds, including NFTs.

You also need XRP to pay the network transaction fee for the NFTokenMint transaction itself. Transaction fees on the XRP Ledger are typically very small.

Verify current reserve and fee requirements against official XRPL documentation, as these values can change through network amendments.

Before minting, decide on the key parameters for your NFT. These settings are permanent — they cannot be changed after the NFT is minted.

NFTokenTaxon: Choose an integer to group your NFTs into collections. All NFTs in a series can share the same taxon.

Flags: Decide whether the NFT should be transferable (tfTransferable), burnable (tfBurnable), or restricted to XRP-only offers (tfOnlyXRP).

TransferFee: If you want creator royalties on secondary sales, set a TransferFee value. This is encoded as thousandths of a percent.

URI: Provide the URI pointing to your metadata JSON file.

Construct an NFTokenMint transaction with your chosen parameters. The transaction must be signed with your account's private key before submission.

You can submit transactions using XRPL client libraries (such as xrpl.js for JavaScript/TypeScript), an XRPL-compatible wallet interface, or direct API calls to an XRPL server.

Always review the transaction details carefully before signing and submitting.

After submitting your transaction, it enters the queue for the next ledger close. The XRP Ledger closes a new ledger version approximately every 3–5 seconds.

Your transaction is included in a ledger close and validated by the network of servers. Once validated, the result is final and immutable.

Check the transaction result code to confirm the transaction succeeded (tesSUCCESS). Any other result code indicates the transaction was not applied.

After successful validation, the ledger assigns your NFT a unique NFTokenID. This identifier is derived from the issuer address, flags, transfer fee, taxon, and a sequence number.

Record the NFTokenID — it is the permanent, unique identifier for your NFT across the entire XRP Ledger.

You can find the NFTokenID by examining the transaction metadata or querying the account's NFT holdings using the account_nfts API method.

After minting, verify that the NFT record on the ledger correctly reflects your intended parameters: the URI, flags, transfer fee, and issuer address.

Confirm that the issuing account holds the NFT by querying account_nfts.

Verify that your metadata URI resolves correctly and that the content matches what you intended. Check that images and media files are accessible.

Your minted NFT is now live on the XRP Ledger. Depending on your goals, you can hold it in your wallet, create a sell offer using NFTokenCreateOffer, transfer it to another account, list it on an XRPL NFT marketplace, or integrate it into an application.

If you configured a TransferFee, that percentage will be applied to qualifying secondary transfers.

XRPL NFT marketplaces and explorers can index and display your NFT based on the NFTokenID and metadata URI.