How XRPL NFTs Work
A clear explanation of the XRP Ledger's NFToken standard — from minting and metadata to ownership, transfers, and royalty mechanics. Accessible to non-technical readers, detailed enough for developers.
The NFToken Standard
The XRP Ledger implements NFT functionality through its native NFToken standard. Unlike blockchains that implement NFTs through smart contracts, XRPL NFTs are a first-class feature of the protocol — defined at the ledger level and processed by validators as native transaction types.
This design has practical implications: NFToken transactions use the same validation infrastructure as all other XRP Ledger transactions, benefiting from the ledger's established settlement speed and fee structure.
The standard supports minting, transferring, burning, and creating offers for NFTs — all through distinct transaction types recorded on the public ledger.
Source note: Technical specifications for the NFToken standard are documented in the official XRP Ledger documentation. Creators and developers building on XRPL should consult primary documentation for implementation details.
Core Transaction Types
NFTokenMintCreates a new NFToken on the ledger
NFTokenBurnPermanently destroys an NFToken
NFTokenCreateOfferCreates a buy or sell offer
NFTokenAcceptOfferAccepts an existing offer, completing transfer
NFTokenCancelOfferCancels an existing open offer
The NFT Lifecycle on XRPL
From creator intent to on-chain ownership — the complete process of creating and transferring an XRPL NFT.
Prepare the Digital Asset
Create the digital content — artwork, music, document, or other media — that the NFT will represent. The actual file will be stored off-chain.
Technical Detail
The XRP Ledger does not store media files directly. Content is hosted externally, with the NFT carrying a URI pointing to that content.
Structure the Metadata
Prepare a metadata file describing the NFT — typically following a standard JSON format including name, description, image URI, and attributes.
Technical Detail
Metadata should be stored in a reliable, persistent location. Metadata permanence is an important consideration — if the metadata URI becomes inaccessible, the NFT's descriptive information may be lost.
Submit NFTokenMint Transaction
Using an XRP Ledger wallet and compatible tooling, submit an NFTokenMint transaction specifying the metadata URI, transfer fee, and minting flags.
Technical Detail
Key parameters include: URI (metadata location), Flags (transferable, burnable), TransferFee (creator royalty on secondary transfers, expressed in basis points).
Token Recorded on Ledger
The XRP Ledger validates and records the NFToken. A unique token ID is generated, permanently embedding the issuer account and other parameters.
Technical Detail
The NFToken ID encodes: issuer account, flags, transfer fee, issuer-defined taxon, and a sequence number — all in a single 256-bit identifier.
Token Held in Wallet
The minted NFToken is held in the issuer's NFToken page — a special ledger object associated with the account that stores NFTs in groups.
Technical Detail
NFTokens are stored in NFTokenPage objects on the ledger. Each page holds up to 32 tokens. Multiple pages can exist per account.
Transfer via Offer Mechanics
To transfer an NFT, the holder creates an NFTokenOffer. The recipient accepts the offer, completing the on-chain transfer.
Technical Detail
Both sell offers (initiated by holder) and buy offers (initiated by prospective buyer) are supported. Offers can be direct (to a specific account) or open.
Key Technical Terms
Understanding XRPL NFT terminology helps creators and collectors navigate the technical aspects of digital collectibles on the XRP Ledger.
NFTokenMintThe transaction type used to create a new NFToken on the XRP Ledger.
NFTokenIDThe unique 256-bit identifier of an NFToken, encoding issuer, flags, transfer fee, taxon, and sequence.
NFTokenPageA ledger object that stores up to 32 NFTokens associated with a single account.
NFTokenOfferA ledger object representing an offer to buy or sell an NFToken.
TransferFeeAn optional creator royalty on secondary transfers, set at minting time in basis points (0–50000, representing 0%–50%).
URIA link embedded in the NFToken pointing to off-chain metadata or content.
TaxonAn issuer-defined number used to categorize or group NFTs from the same issuer.
FlagsMinting parameters controlling whether an NFT is transferable, burnable, or has other properties.
Transfer Fees and Creator Royalties
When minting an NFToken, creators can specify a TransferFee — a percentage of any future sale proceeds that is sent to the issuer account on secondary transfers. This provides a mechanism for ongoing creator participation in secondary market activity.
The TransferFee is expressed in basis points and can range from 0 to 50000 (representing 0% to 50%). Setting a TransferFee also requires that the tfTransferable flag is enabled.
Important: Transfer fee enforcement depends on marketplace and platform support. Not all applications may honor transfer fee mechanics. Creators should verify how platforms they work with handle TransferFee parameters.
Transfer Fee Parameters
0No transfer fee — no creator royalty on secondary sales.
10001% transfer fee on secondary sales.
50005% transfer fee on secondary sales.
5000050% — maximum transfer fee allowed by protocol.