Before you submit your bot to Top.gg, please make sure that your bot follows all of our guidelines found here and read over our process for approval found here.


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. 


Short Description

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!


Long Description

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.


Important Reminder
Putting a prefix that does not correctly match your bot when a Bot Reviewer attempts to test it will result in your bot being declined.



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.


Selecting Languages

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.



Invite URL

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.


Support URL

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. 



Important Reminder
You must check the box that says “I understand that my bot needs to be online to pass review.” before you can submit your bot to the queue.


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.