Whitelist Manager Bot

Collect wallet addresses from your community
NEW: Customize the whitelist bot with your own branding! Custom bot avatar, name, logos, submission panel title and text. For 2.5 Premium subscribers only.
This is our newest bot for collecting wallets. It replaces the older NFT Whitelist Wallet Bot. Do not use the older bot at the same time as it may cause this bot to function incorrectly.

New features

  • Customization & whitelabeling. Fully customize the bot avatar, name, logos, submission panel title and panel text.
  • Multiple whitelists. Create multiple whitelists for your different collections and giveaways.
  • Easier configuration. Configure the whitelist and send the wallet submission panel from just one command.

Getting started

Welcome! The 2.5 Whitelist Manager Bot lets you collect the wallets for your NFT collection's whitelisted members with the greatest ease!

Installation

When the bot is installed, Discord will create a role called 2.5 Whitelist Manager Bot. Do not edit this role.
If at any point you accidentally modify the bot role, please make sure the bot has the following permissions:
  • View Channels
  • Manage Roles
  • Send Messages
  • Embed Links
  • Attach Files
  • Change Nickname

How to use this bot

The 2.5 Whitelist Manager Bot makes it very simple to collect your whitelisted users' wallet addresses.
You'll first need to figure out the requirements for your users to get on the whitelist. For example, you might require your users to follow your Twitter and like and retweet your posts; achieve a certain activity level in your Discord server; or invite some number of people to your server.
Once you have determine your whitelist requirements, create the role(s) that users will receive once they have met the requirements. These are the Whitelisted Roles that you'll set in the bot.
Next, follow our Quick start guide to set up the bot so that the users who meet the requirements can submit their wallets.

Quick start

  1. 1.
    Create a new whitelist with the /configure command.
  2. 2.
    Select a channel for wallet submission and set the bot's whitelist channel to that channel. This channel should only be accessible to whitelisted users.
  3. 3.
    (Advised) Set the blockchain your project is on. Setting a blockchain allows the bot to validate the format of every submitted address and reject invalid addresses. Additionally, for ETH, MATIC, and SOL, setting the blockchain allows you to configure a minimum balance required for users to submit their wallets.
  4. 4.
    (Optional) Set whitelisted roles, the roles that are eligible to submit their wallets. These are the roles that should have access to the whitelist channel.
Once you have set your whitelist roles and started collecting, do not remove a role! You can add roles but always include the previous roles in the list!
5. (Optional) Set the wallet submitted role, the role that users will receive when they successfully submit their wallets.
6. (Optional) Set the wallet admin role. Wallet admins can use additional commands. See the commands section for more info.
7. There are many other settings you can configure. For example, you can require a minimum wallet balance (ETH, MATIC, SOL only), set a maximum number of wallets to collect (for the entire whitelist), or require users to follow your Twitter account and retweet a tweet. See the commands section for more info. To view your current configuration, you can use the /viewconfig command.
8. When your whitelist settings look good, send the whitelist submission panel to the whitelist channel. (You can also use the /send-submissionpanel command.) Your users can click the buttons in the panel to submit and check their wallet address.
9. To download your collected wallets, use the /download-wallets command. You have three options: a simple list of addresses, a list with in-depth information (Discord id, username, and so on) and a full 2.5 Intelligence report in Google Sheets.

Commands

General commands

/disconnect-twitter
Disconnect the Twitter account connected to your Discord account.
/help
Shows the bot documentation (i.e. this site).

Configuration (Server admins only)

/configure
Creates a new whitelist or configures settings for an existing whitelist.
The settings you can configure:
  • Whitelist channel: Sets the Discord channel in which wallets wil be collected.
  • Blockchain: Sets the blockchain for which wallets will be collected.
  • Add whitelisted roles: Add roles that are eligible to submit their wallet.
  • Remove whitelisted roles: Remove roles that are eligible to submit their wallet.
  • Whitelist status (Open/Closed): Open or close submission for the whitelist.
  • Maximum wallets (Total for entire whitelist): Limit the total number of wallets that can be collected for this list. (First come first served.) Each user can submit one wallet.
  • Delete wallet if a user leaves the server?: When turned on this will delete submitted wallets from people who leave the server.
  • Wallet admin role: Set a role for admin access to this whitelist.
  • Minimum wallet balance (ETH/Matic/SOL): Require users to have at least this amount in their wallet to submit their wallets.
  • Wallet submitted role: Set the role that people will receive after they submit their wallet.
  • Submission panel title: Customize the wallet submission panel title.
  • Submission panel text: Customize the wallet submission panel text.
  • Twitter follow account: Set the Twitter account people must follow to submit their wallet.
  • Required Twitter retweet: Set which tweet people must retweet to submit their wallet.
  • Change name: Change the name of the whitelist.
  • Reset: Reset all settings, all wallets, or both.
  • Delete whitelist: Delete the selected whitelist.

Other commands for server admins

/download-auditlog Downloads the audit log for a specified whitelist. Audit logs contain records for every use of the /add-wallet and /remove-wallet commands.

Commands for wallet admins

/add-wallet whitelist @user Wallet Address Adds or changes the wallet in the specified whitelist for the specified user. Logs the action to the audit logs.
/remove-wallet whitelist @user Removes the wallet in the specified whitelist for the specified user. Logs the action to the audit logs.
/count-wallets Shows you have many wallets have been submitted for each whitelist.
/viewconfig Shows you the configuration for a specified whitelist.
/download-wallets Sends a file to the channel with all the collected wallets for a specified whitelist. Full reports are deleted in 90 days. Please download them if you'd like to save them.
/count-wallets and /download-wallets
/send-submissionpanel Sends the whitelist submission panel for a specified whitelist to the whitelist channel.
In order for the bot to grant users the wallet submitted role, the NFT Whitelist Wallet Bot role must be higher than the wallet submitted role.
The "NFT Whitelist Wallet Bot" role is above the wallet submitted role, "Whitelisted."
For a more in depth configuration, check out the GIF below.

Questions and Feedback

Frequently Asked Questions

Use the /disconnect-twitter command.
Please make sure the bot has the following permissions: View Channels, Manage Roles, Send Messages, Embed Links, and Attach Files.
​
​
​
​
​
​
​
​
You can collect up to 1000 wallets as a free user. Upgrade to a premium subscription to collect an unlimited number of wallets.
Yes. And when you download the wallets, the bot will generate a separate file for each role.
No, but you can create multiple whitelists and have separate submission panels in different channels for each list.
The user might be using an outdated version of the Discord mobile app. Ask the user to update his/her/their app.
Rename the file from <x>.txt to <x>.csv. Then you can open the file in Excel. Also, if you download the "Detailed List," the files will be CSVs by default.
Yes. Please join our Discord server and open a #support ticket. ⚠️ If your wallets do not have Discord user IDs associated with them, the bot won't be able to ensure that a user doesn't submit two wallets (one wallet from your imported list, and one wallet through the bot).

Verified wallet role permissions error

"Your wallet has been recorded but I couldn't assign you the verified wallet role"
In order for the bot to grant users the wallet submitted role, the NFT Whitelist Wallet Bot role must be higher than the wallet submitted role.
Please go to Server Settings > Roles, and drag the "NFT Whitelist Wallet Bot" role above the wallet submitted role.
For live support, please become a premium user.

Are you enjoying the bot?

Please leave us a nice review on top.gg. We really appreciate it.

Do you want to track mints of your collection in real-time?

Check out our NFT Mint Bot. We use private ethereum nodes to guarantee speed and reliability. (All of our bots are free.)

Do you want to track sales and listings of your collection in real-time?

Check out our NFT Sales & Listings Bot. It's easy, fast, and reliable.