Whitelist and Royalty Options

Whitelist and Royalty settings are completely optional but can add value to your project


Whitelisted addresses have different permissions than other addresses over the collection they are whitelisted.

They can mint tokens from a collection

  • At reduced prices

  • Before the start time

  • At a quantity defined by you

Using Stargaze Studio you can provide a whitelist and specify their permissions. You can set the following information:

  • Unit Price: Token price for whitelisted addresses.

  • Member Limit: Maximum number of whitelisted addresses.

  • Per Address Limit: Maximum number of tokens a whitelisted address can mint

  • Start Time: Start of minting time for whitelisted addresses

  • End Time: End of minting time for whitelisted addresses

  • Whitelist File: The txt file that contains whitelisted addresses.

The start and end time for whitelisted minters must be before the public start time.

The whitelist file is a simple .txt file where each line consists of one Stargaze address. The file should look like the following:


Everything about the whitelist is ready. You can publish the collection in its current state or add a royalty percentage by following the next step.

Whitelist Types

There are two different whitelist contracts available for Open/Limited Edition creators, each with different utility.

1) Standard Whitelist

The Standard Whitelist allows for up to 5000 addresses. In the Standard Whitelist, settings are universal meaning that all addresses will be eligible to mint the same amount of tokens at the same price as dictated by creator settings.

2) Whitelist Flex

The Whitelist Flex allows for up to 10,000 addresses. Whitelist Flex allows for different token mint limits per address.


Royalties are payments that are transferred to an address every time an NFT from that collection is sold in the marketplace.

You only need to set two parameters:

  • A payment address that will receive the funds

  • The share percentage you want from each sale

If you are done with the configurations, press the Create Collection button and sign the pop-up transactions.

Unlike the previous section, you will receive two different transactions to sign. The first one is to instantiate the whitelist contract and the second one is to publish the collection.

An info box will appear at the top of the page when the transactions are confirmed.

It is important to save all the printed information as you'll need the addresses to interact with the collection. Visit the Interact with a Collection page to learn about the interactions you can have with the collection after the launch.

Congrats! You have successfully learned how to create a collection with whitelist and royalty configurations.

Last updated