Skip to main content
All CollectionsCreator ResourcesSafeguarding Creator Royalties
Setting Up Royalties on Magic Eden's EVM Platform
Setting Up Royalties on Magic Eden's EVM Platform

Navigating royalties on Magic Eden's EVM marketplace for ERC721C collections.

Updated this week

In this guide, we'll walk you through the details of royalty settings on our platform including a FAQ section, allowing you to maximize your earnings and take full advantage of the opportunities offered by the NFT market.

Understanding royalty settings

In general, royalties provide creators with a mechanism to earn a percentage of the resale value for their work, ensuring some form of continued compensation for their creations.

Recent advancement like ERC721C offers a comprehensive avenue for creators to secure their earnings. With ERC721C, creators gain enhanced control over their royalties, allowing for enforceable on-chain programmable royalties—a significant step towards fairness and transparency. This contract effectively allows creators to block platforms which do not respect creator royalties.

For ERC721C Collections, royalties are paid out in a structured manner to prioritize creator compensation:

1. ERC2981 setup

Initially, if a collection has ERC2981 setup on the contract, royalties will be distributed according to the specifications of this protocol. This ensures seamless and transparent royalty payments for creators.

2. PaymentProcessorV2 (PPv2) backfilled royalties

In cases where ERC2981 setup is not available, Magic Eden utilizes PPv2 backfilled royalties as an alternative method. This ensures that creators still receive their rightful share of the resale value, enhancing the overall fairness of the marketplace.

Setting up PPv2 backfilled royalties

To set up PPv2 backfilled royalties for your collection, follow these step-by-step instructions:

Connect to developers.freenft.com

Visit developers.freenft.com and connect your wallet as the contract owner.

Manage your collections

Navigate to the "Manage my collections" section and input your contract address. Click "RETRIEVE CONTRACT DATA" to proceed.

Configure payment processor settings:

Scroll down to locate the "Payment Processor Settings" section. Here, you'll find "Configuration Settings" where you can input the "Royalty Backfill Numerator" and "Royalty Backfill Receiver" values.

Update settings

Once you've entered the required values, click "UPDATE PAYMENT PROCESSOR SETTINGS" to finalize the setup. Please note that a gas fee will apply for this transaction.



ERC-2981 FAQ:

How are royalties configured using ERC-2981?

  • Creators set a default royalty amount when the contract is deployed.

  • Creator adds a custom “update” function so they can change the royalty rate after the contract is deployed.

How can creators update to ERC-2981 royalties?

  • By default, ERC-2981 does not come with a way to update royalties after the contract is deployed, so you will need to add this yourself if you wish to change their royalty rate in the future.

How does a payment processor utilize ERC-2981 to facilitate royalty payments?

  • ERC-2981 is the primary method payment processor uses to pay royalties. It reads this data on-chain from the NFT contract when an item is purchased. Payment processor attempts to call the “royaltyInfo” function on the NFT contract to determine how much royalties should be paid, and to which address.

Is it possible for creators to add ERC-2981 to their existing contract?

  • Only contracts that are “Upgradeable” can add ERC-2981

What if the creator Is unable to add ERC-2981?

  • Creators should configure “backfilled” PPv2 royalties on their contract.


Backfilled PPV2 Royalties FAQ:

Trouble updating backfilled royalties?

  • In order to update backfilled royalties, creators must connect to the website using the address of the contract OWNER. The contract owner is defined by implementing EIP-173 on their contract or by using OpenZeppelin Ownable Implementation which adds a “owner” function to the contract which payment processor will check for when updating the backfill royalty.

What if the creator doesn't have ownership of the contract (i.e., Not Ownable)?

  • Creators can rely on Royalty Registry if it's already configured, or work with us to set up custom royalties.


If you have any questions or require assistance, our dedicated support team is here to help. Simply reach out to us via the chat widget on our website, and we'll be happy to assist you every step of the way.

Did this answer your question?