Before you continue reading this document, take a look at our explanation of the bot reviewal process here.
Where to submit your bot?
Once your bot has fulfilled all of our guidelines stated in the above document, you can head over to https://top.gg/bot/new to start the submission process! Once you are ready, make sure to first login to the site or you will not be able to start your submission.
Where to find your client’s ID?
To receive your client’s ID, head over to the Discord Developer Portal and select your application.
Once you have entered this page, navigate to the application ID and copy it.
Once copied, paste the ID into the “Client ID” field and press “Find Bot”. Your bots username and image will then be displayed and the other fields will become available to fill!
Short and long descriptions
To draw attention to your bot and explain its purpose, you need a description! There are two different descriptions, both of which are very useful and help give your audience an idea of what your bot does!
What is the short description?
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.
What is the 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. Your description needs to be at least 300 characters long and should capture what your bot can do.
What is the bot’s prefix? What does this mean?
Your bot’s prefix is simply what triggers your bot to run a command, for example: “-help”. In this case, “-“ is the prefix as it is what comes before the command to trigger it. If your bot does not have a prefix, simply put “none”. For slash command only bots, you can put “/“ in this submission box.
Putting a prefix that does not correctly match your bot when the bot reviewal team attempts to test it will result in a decline, as well as putting spam content here.
Tags? How do they relate to your bot?
When a user is searching for a bot they want to add to their server, they can use the tags feature to search by a specific category that suits their needs. You are able to add tags to your bot so that it can be seen in specific categories for users to find. Each bot may have up to 6 tags of the developers choice.
Optional parameters and fields
When initially submitting your bot, you have access to 3 optional parameters that you are able to fill to add more resources a user can access to help them with your bot!
The invite URL parameter allows you the ability to provide a discord invite link with custom permissions that your bot will need. If not entered, a default “0 permission” link will be generated for users to use.
Support Server Link
The Support Server Link parameter gives you the ability to link your top.gg server into your bots page for users to go to if they need information/help on your bot. Make sure your server is added to top.gg and public at https://top.gg/servers/me
The Support URL option is a way to add your bot’s support server invite link into your bot page so that users can join directly if they need support with the bot. Make sure the invite has infinite uses so it doesn’t expire!
All options stated above excluding the client ID can be edited/changed after submission at https://top.gg/bot/BOTID/edit while being logged into your account.