#faq
1 messages · Page 1 of 1 (latest)
This server is the official support and community server for Top.gg; https://top.gg
We are not a support server for any specific bot except for @timid mantle.
Top.gg aims to facilitate connecting users to interest-driven communities by enabling contextual discovery. Our vision is to become the center of gravity for community building and discovery.
We are not affiliated with https://discord.com
You can submit your bot to our website here: https://top.gg/bots/new
You can add your server to our website by first inviting the @timid mantle bot here: https://top.gg/servers/invite and then finding the server on your profile; https://top.gg/profile/me.
The Top.gg bot gathers information from your server such as member count and emojis. Servers go through our automoderation process and can be found on the website immediately as long as they follow our guidelines.
Bots go through a queue, so all of the bots that were submitted earlier will be approved first. It can take up to a week (or longer) for your bot to be approved or declined manually by one of our <@&767389896133443625>.
Please be patient as it takes time for our volunteer staff to work through the queue. Do not ask for your bot to be reviewed, queue is reviewed in order of submission.
You can use our Teams feature to share ownership of your bot or server page with another Top.gg user, or allow them to take ownership of the page completely. More information on Teams can be found here: https://support.top.gg/hc/en-us/articles/23146808091164-Teams-Overview
If you have completely lost access to the bot or server page on our website, such as due to your Discord account being lost or disabled - please read this support article for instructions: https://support.top.gg/hc/en-us/articles/23143255132700-Project-Ownership-Transfers
This happens when you update your bot information on the Discord Developer Portal. Top.gg needs to be told to fetch the new bot data from the Discord API. In order to fetch your new bot avatar / name, please use the “Refresh Data” button on the right sidebar. If it still doesn't seem to change, make sure you actually changed the bot avatar on https://discord.com/developers/applications and not the application icon / make sure you have changed the bot name and not the application name.
Please note: It may take between 30 minutes to an hour for the site-cache to also update. During this time, your changes may not be immediately reflected on the site. Please wait for an hour, clear your cache and reload the page.
Auctions provide valuable growth and a boost in discovery for your bot, community, project, creation, or company -- millions of users visit Top.gg every week to find and discover Discord Bots and Discord Servers! Auctions are a way for anyone interested in advertising on Top.gg to bid on featured spots on our platform. To learn more about how auctions work in detail and to understand our guidelines for advertising Top.gg, read our support article here: https://support.top.gg/hc/en-us/articles/23146173577372-How-Do-I-Use-Auctions and also check out #auctions-faq !
Check out Auctions here: https://top.gg/advertise
To make a bug report, please submit a ticket at https://support.top.gg ! Please make sure to provide as much detailed information as possible, so that we can help you troubleshoot the issue! You can also use the #support or #auctions-support channels here if there is an issue you’d like help with in real time. For issues that contain personal details or involve other sensitive information, please use #auctions-tickets for Auctions issues or submit a ticket via https://support.top.gg.
To submit feedback, we recommend submitting a ticket at https://support.top.gg or utilizing #1314012335320596520 (available to those with the <@&265125253443878912> role) - you can make your own suggestions or upvote those of other users that you agree with.
There are lots of ways you can get involved and give back to the Top.gg community! We have a diverse group of people in our volunteer staff team located all across the globe. You can check out open applications for volunteer staff positions such as Reviewers in #announcements .
Are you a developer, or do you have skills we might be looking for as we scale our Team? Pick up the <@&971143684013846539> role in id:customize and keep an eye on #announcements - we’ll post there when we are hiring!
To display your bots server count on its Top.gg page, you will have to publish your stats via the API. You can do this easily by using one of the handy libraries listed on https://docs.top.gg or by writing your own implementation using the endpoints listed on the same documentation. To use the API to update bot statistics, you will need to have an approved bot to get an access token which you can find on https://top.gg/bot/bot:id/webhooks. If you need help or have questions, please use #topgg-api!
A starboard is, simply put, a system where a collection of people can "star" a message to have it saved in a channel.
Content that is usually starboard worthy:
Memes and other funny community content.
Content that is not starboard worthy:
Random messages that aren't really funny or entertaining at all.
Your own messages, nobody wants to see your "Star this message for..." message.
Advertisements or self promotions (obviously).
Hateful messages of any kind.
Not following the starboard rules will result in a mute.
If you haven't made a bot before, but you want to, start here:
Coding a bot requires the knowledge of a programming language, you can use any of them to make a bot. The most common is Javascript, but others include Python, Rust, Go, C++, Java, and more.
A bot often uses a library to interact with the Discord API, so you should find a library for your chosen language and learn how to use it.
If you want to learn from the beginning, you can find some good guides here:
https://discordjs.guide/#before-you-begin (Javascript - library Discord.js)
https://discordpy.readthedocs.io/en/stable/quickstart.html (Python - library Discord.py)
You can find other libraries for other languages and their documentation linked here: https://discord.com/developers/docs/topics/community-resources#libraries
You can ask for additional help with making a bot in #development .
Important things you should know:
If you created a bot on https://discord.com/developers/applications/ - you must code that bot yourself and then run the code for it to come online. There is no way to "turn on the bot" or "power it on". Bot's are run using code and require code in order to have functionality.
Bot development does NOT start with adding your bot to https://top.gg/ . Once you feel like you're ready to make your bot public, you can read here to learn how to add it to our site: https://support.top.gg/hc/en-us/articles/23135162935708-How-to-Add-Your-Bot