Royalties

Immutable’s ecosystem enforces royalty fees to content creators when assets are bought and sold. Royalty fees are set during minting and configured in the smart contract.

Contracts Repository

View royalty implementation source code

How Royalties Work

When an NFT or SFT is sold on the secondary market, a royalty fee automatically directs a portion of the transaction value to the original creator.

Component	Description
Royalty Percentage	Set at contract deployment (e.g., 5% = 500 basis points)
Recipient	Address that receives royalties (can be a Fee Splitter)
Standard	EIP-2981 for on-chain royalty info
Enforcement	Via Operator Allowlist

Royalty fees are optional—it’s up to the collection owner. If set, Immutable’s ecosystem enforces payment.

Setting Royalties

Via Hub

Go to Hub → Contracts → Deploy
Select your contract type (ERC-721 or ERC-1155)
Configure:
- Royalty Recipient: Address to receive royalties
- Royalty Percentage: Percentage of sale price (e.g., 5%)
Deploy contract

Via Code

import "@imtbl/contracts/contracts/token/erc721/preset/ImmutableERC721.sol";

contract MyNFT is ImmutableERC721 {
    constructor(
        address owner,
        string memory name,
        string memory symbol,
        string memory baseURI,
        string memory contractURI,
        address operatorAllowlist,
        address royaltyReceiver,  // Royalty recipient
        uint96 royaltyFeeNumerator // 500 = 5%
    ) ImmutableERC721(
        owner, name, symbol, baseURI, contractURI,
        operatorAllowlist, royaltyReceiver, royaltyFeeNumerator
    ) {}
}

Fee Splitter

For distributing royalties to multiple recipients, use the Fee Splitter contract.

Fee Splitter Contract

View the Fee Splitter source code

Key Features

Multi-Recipient Support: Allocate fees to multiple recipients
On-Chain Transparency: Wallet addresses and shares stored on-chain
Gas Efficiency: More efficient than real-time splitting

How It Works

Set the Fee Splitter contract as your royalty recipient
Configure recipients and their percentage shares
Fees accumulate in the Fee Splitter contract
Call releaseAll() to distribute accumulated fees

// Releasing fees to all recipients
feeSplitter.releaseAll([USDC_ADDRESS, WETH_ADDRESS]);

// Release only native token (IMX)
feeSplitter.releaseAll();

ERC-20 Allowlist

The Fee Splitter includes an allowlist for accepted tokens:

// Add token to allowlist
feeSplitter.addToAllowlist(ERC20_ADDRESS);

// Remove token from allowlist
feeSplitter.removeFromAllowlist(ERC20_ADDRESS);

Unlisted tokens sent to the Fee Splitter won’t be distributed until added to the allowlist.

Updating Allocation

Admin users can update fee allocation. When updated:

All unreleased fees are redistributed according to the new configuration
Existing minted assets automatically use the new configuration

Call releaseAll() before changing allocation to distribute fees according to the original configuration.

Multiple Fee Splitters

Different scenarios require separate Fee Splitter contracts:

Scenario	Solution
Different recipients	One contract per unique recipient combination
Different percentages	One contract per unique split ratio
Multiple games	One contract per game/collection

Royalty Enforcement

Royalties are enforced through the Operator Allowlist. Only allowlisted marketplaces (like Immutable’s Orderbook) can transfer tokens, ensuring royalties are always paid.

Operator Allowlist

Learn how royalty enforcement works

Deploy Contract

Deploy a contract with royalties

Next Steps

Operator Allowlist

Learn about royalty enforcement

Deploy Contracts

Deploy via Hub with royalties

Contracts Overview

Explore contract options

Orderbook

Enable secondary trading

PRODUCTS

GUIDES

Contracts Repository

How Royalties Work

Setting Royalties

Via Hub

Via Code

Fee Splitter

Fee Splitter Contract

Key Features

How It Works

ERC-20 Allowlist

Updating Allocation

Multiple Fee Splitters

Royalty Enforcement

Operator Allowlist

Deploy Contract

Next Steps

Operator Allowlist

Deploy Contracts

Contracts Overview

Orderbook

Contracts Repository

​How Royalties Work

​Setting Royalties

​Via Hub

​Via Code

​Fee Splitter

Fee Splitter Contract

​Key Features

​How It Works

​ERC-20 Allowlist

​Updating Allocation

​Multiple Fee Splitters

​Royalty Enforcement

Operator Allowlist

Deploy Contract

​Next Steps

Operator Allowlist

Deploy Contracts

Contracts Overview

Orderbook

How Royalties Work

Setting Royalties

Via Hub

Via Code

Fee Splitter

Key Features

How It Works

ERC-20 Allowlist

Updating Allocation

Multiple Fee Splitters

Royalty Enforcement

Next Steps