Make sure that you are logged into https://top.gg, then navigate to https://top.gg/bot/new to start the submission process! You can access this by clicking on “Add” in the navigation bar and then selecting “Discord Bot”.
Step 1. Find Your Bot’s Application ID
To find your bot’s application ID, head over to the Discord Developer Portal and select your application.
Once you have selected your application, navigate to the “Application ID” and copy it.
Once copied, paste the ID into the Application ID field and select “Find Bot”! Your bot's username and profile image will then be displayed and the other fields will become available to fill.
Step 2. Bot Details
Here you can fill out more information about your bot- such as what it does, what commands it has, where users can find support, etc.
Pro Tip: Your bot’s short description contributes heavily to it showing up in search results. Keep it simple and to the point for best visibility.
The short description is meant to give a brief summary of your bot that users will see when scrolling through searches or the discovery page or when they look at your profile. This can be used to draw attention to certain categories, or features that are unique to your bot. Your short description needs to be under 140 characters, to fit the page!
The long description is meant to give a more detailed description and explain how to use the bot or what its functions are. If you’re running out of ideas of what to write in this section, try exploring the following:
Include a list of your commands and an overview of your features
Include an introduction, goal, roadmap and vision for your bot
Include information such as motivation for creating your bot, and collaborators
Include information about how to support your bot and help it grow
Your Bot’s Prefix
When submitting your bot, you’ll be requested to add your bot’s prefix. This is simply what triggers your bot to run a command.
For example: if your bot responds to -help then your prefix is -. If your bot does not have a prefix, simply put “none”. If your bot responds to slash commands, you can put ‘/’ in this submission box.
Selecting Relevant Categories
When a user is searching for a bot they want to add to their server, they can use the categories feature to search by a specific category that suits their needs. You are able to add categories to your bot so that it can be seen on specific pages for users to find. Each bot may have up to 12 categories of the developers choice.
Does your bot support multiple languages? Feel free to add them here. Users will be able to search for bots that are in their language or support their language. You can add up to 12 languages to your bot.
The invite URL submission box allows you the ability to provide a discord invite link with custom permissions or scopes that your bot will need. If you do not enter one, a default link with permissions set to 0 (or none) will be generated for users to use.
Top.gg Server URL
The Top.gg Server URL submission box allows you the ability to link your Top.gg server into your bot’s page for users to join if they need information/assistance with your bot. Make sure your server is added to Top.gg and public at https://top.gg/servers/me. If you need to add your server, check out our Add Server article.
The Support URL submission box allows you to directly link your bot’s Discord support server into your bot page so that users can join directly if they need support. Make sure the invite has infinite uses so that it doesn’t expire!
Note for Reviewer
If you would like to give a note to the Bot Reviewer who will be testing your bot - you can do so in this submission box. Let them know the information that they need to properly test your bot. This can include example accounts or commands they can run to understand properly what your bot can do!
Step 3. Confirmation
Read through the confirmation page and make sure that all the information listed is correct for your bot.
Step 4. Waiting for Verification
Hooray! Your bot has now been successfully added to the queue of bots that need to be reviewed before they can be public on Top.gg. Please wait patiently for a Bot Reviewer to review your bot. In the meantime, you can see your own bot’s page and edit anything necessary.