For developers
What you need to list your bot here, and what happens afterwards.
Submit
Six steps, progress saved as you go. You need the application ID from the Developer Portal, two descriptions and an invite URL.
Prove ownership
We generate a text that you temporarily put into your application's description. Only an owner or team member can change it.
Automated pre-checks
We take the invite apart, check every link, look for duplicate listings and read the text. Anything that fails hard comes straight back with reasons.
Review by hand
A person invites your bot to a server and works through a checklist. We aim to do that within 72 hours.
What a listing gets you
No reach promises, we'll make those when the numbers back them up. This is what you get from day one.
A bot page built to be found
Server-rendered, loads in under two seconds, clean schema markup, two languages. Built so a search for your bot name can land on your page instead of only on other directories.
Server counts confirmed by Discord
If your bot is listed in Discord's App Directory, we adopt its server count daily as your visible number for as long as you don't report one yourself; your own API reports take precedence. The history shows exactly that number: as an embeddable SVG widget and, optionally, as a chart on your bot page (switchable in the dashboard).
Badges for your README
Server count, votes or rating as a badge in both themes, with copy snippets as HTML and Markdown in the dashboard. This is live:
API and vote webhooks
Post your server count, query votes, hand out rewards: HMAC-signed webhooks with retries and a delivery log, plus a documented API with JavaScript and Python examples.
Sell premium directly to your users
Subscriptions and one-off support through your bot page, handled via Stripe Connect, even if Discord's own monetization isn't open to you. Standard fee 10%; founding developers pay 0% in the first year.
Already listed on top.gg? How to run a second listing in five steps
For the first 25 only
Founding developer
Topbot.gg is new, and that's your edge: the first 25 developers whose bots pass review get terms that won't exist later.
1 / 25 taken
Applies to bots that pass review. One spot per person. The counter above comes from the database.
- 0%
Commission on premium sales, 12 months
Sell subscriptions and accept one-time support right on your bot page: through Stripe, including outside the US, UK and EU. For the first 12 months you keep everything but Stripe's fees; after that the standard 10% applies.
- 30 days
Featured on the homepage
A featured spot after approval, labeled “Sponsored”. It's the same placement that will cost money later.
- Permanent
Founder badge on your listing
Stays on your bots for as long as they're listed. This is what it looks like:
Founder- 1 : 1
A direct line to the operator
Review, questions and requests go through one person, not a ticket system. Replies usually the same day.