A directory for finding bots and servers
Top.gg is a directory where people browse Discord bots and communities. A listing gives your bot a page with a description, links, and information that helps someone decide whether to try it.
Directory traffic is only the start. A clear install flow and a working first command matter once someone leaves the listing. Treat the page as an introduction to the bot, not a substitute for documentation.
the first sentence
Say what the bot helps people do.
“Schedule study sessions across time zones” tells a reader more than “the ultimate community bot.” Lead with the task, then show the command that completes it.
Prepare and submit your listing
Check the guidelines
Read Top.gg’s submission guide and linked bot rules before filling in the form.Add the application ID
Sign in and open the Add Bot form. Use the application ID from Discord’s Developer Portal, then confirm that the correct bot appears.Fill in the useful details
Write a short summary, a longer introduction, accurate categories, a working invite, and a support link.Give reviewers a working example
Keep the bot online and explain how to test features that need setup. Review notes should help someone use the bot without guessing.Follow the review result
Check the status and address any requested changes. Review time varies; do not plan a launch around a guaranteed approval date.
Help the first visitor succeed
- Show the main use case near the top of the description.
- Include a short setup example with the correct command names.
- Explain required permissions and any paid features.
- Use screenshots that match the current bot.
- Check that support and invite links still work after changes.
Try the install process in a server where the bot has never been used. A feature that works in your development server may depend on a role, channel, or permission that new users do not have yet.
Keep voting prompts reasonable
If you offer voting rewards, read Top.gg’s voting guidelines. Make rewards clear, verify events before granting them, and handle repeated delivery without duplicating the reward.
Use the platform’s current voting interval and API documentation. Avoid building reminders around a value copied from an old guide. Let people opt into reminders instead of sending unexpected DMs.
Measure more than listing views
Track successful installs, first command use, and whether servers keep using the bot. These tell you whether the listing attracts the right people and whether setup works.
You can also list on Rank.top and compare the results. Keep the description consistent across directories, then use bot analytics to see which sources lead to active users.