Skip to content

Changelog

What shipped, and what it changes for you.

Discord servers in the directory

Topbot.gg now lists Discord servers, not just bots. Use the new menu in the header to switch between bots, servers and hosting.

Find servers

  • A dedicated directory at https://topbot.gg/en/servers with search, sorting and a language filter
  • 14 categories and 32 tags, made for communities
  • Every server page shows members, online count, boosts, founding date, welcome screen, emojis and member history
  • Voting and reviews work just like they do for bots

List your server

  • Connect Discord, pick your server, describe it in five steps
  • Anyone with "Manage Server" on that server can list it
  • Checks run automatically, and clean listings go live right away

For bot developers

  • When a server team adds the Topbot app, their server page shows the listed bots running there
  • In return, your bot page shows the listed servers your bot runs on
  • Public profiles now show bots and servers, as a grid or a list

New for submissions and hosting
To submit a bot, list a server or host a bot, you now need to be a member of this server. Questions and approvals happen here, and our bot can only message you if you share a server.

App Directory mirror: 4,700 bots in search, claimable

Search now shows a separate section below the reviewed listings with around 4,700 public bots from Discord's App Directory. Each one has its own page with an invite button — clearly marked as not reviewed by us, with no votes and no ratings. Name, description and server count come from Discord and refresh weekly.

For developers:

  • Your bot is in there? “This is my bot” on its page opens the submission with the application ID prefilled. Prove ownership, pass review — and the page is yours, with votes, statistics, badges and premium sales.
  • While your claim is in progress, everything you enter stays private. Your listing only goes public after approval.
  • The first 25 developers become Founding Developers: 0% fee on premium sales for the first year, 30 days on the homepage, a permanent founder badge.
  • Don't want to appear in the mirror? A short message via the contact page is enough and we'll remove the entry.

Sell premium for your bot right on Topbot.gg

Starting today, every listed bot can earn money: your bot page gets a purchase section with subscription tiers and one-time support.

How it works

  • Connect your payout account in the dashboard under Premium (Stripe, takes a few minutes). Payments go straight to your account; Topbot.gg keeps a 10% fee.
  • Create up to four tiers: priced in EUR or USD, monthly or yearly. A tier applies to one person or to one server; for server tiers the buyer enters the server ID at checkout.
  • No tiers yet? Your page still shows the support section for one-time contributions.

Integrating with your bot

  • Your existing webhook receives two new events: premium (when a subscription starts or ends, including the server ID) and donation. Signed exactly like votes.
  • New in the API: GET /bots/{id}/premium/{userId} and GET /bots/{id}/premium/guild/{guildId} check subscription status. Your API key needs the new premium:read scope for these.

Details and code samples: https://topbot.gg/en/developers/api

The Discord app, six tools, and every invite form

Topbot.gg is now a Discord app. Install it for yourself or your server and the directory lives in your chat: /search searches with typo tolerance and synonyms, /bot shows a card with invite and vote buttons, /top lists this month's ranking, /vote casts your vote right there (same 12-hour cooldown as the site), and /remind turns on vote reminders by DM. If you host with us, /hosting status, /hosting logs and /hosting restart check on your bot without opening a browser. In the support server the app also posts a daily digest and the monthly ranking.

Linked Roles. Server admins can bind roles to Topbot.gg stats: published bot, votes cast, verified bot, hosting customer, member since. Discord checks the condition itself; our app does not need to be in your server for it.

Six tools under /tools. Next to the invite checker: a timestamp generator, snowflake decoder, embed builder, slash command checker and a bot starter. Everything runs in your browser; nothing leaves your machine. Plus two guides: Discord timestamps and free bot hosting.

Every invite form can be listed now. Submissions used to require the bot scope. All three forms work now: the classic bot link, commands-only (applications.commands, no bot member joins), and the short no-scope link from the Developer Portal. For the short link we read scopes and permissions straight from your app's install settings, including the new Installation page format. Permission displays on bot pages and in the review panel say where they came from.

Submitting with less typing. The command list now accepts Discord's JSON export and pasted Markdown tables instead of making you retype everything. A support server is required now (the reviewer looks inside), and before submitting you confirm two things: a help command exists, and the bot is online. The form explains drafts, the invite link and images itself, and you join the support server through a regular invite.

Also: Bot pages are reachable by application ID; topbot.gg/en/bots/(your ID) redirects to the listing. "Searched, not found" shows which bots people looked for and could not find, with counts. Hosting works without a directory listing now: your bot token is the proof of ownership. Daily stats add up correctly again, and the bot card in Discord shows ratings from the very first review.

Hosting: ZIP upload and more git hosts

Creating a hosted app now offers two sources:

Upload a ZIP. No repository needed. Pack your project folder as a ZIP (up to 32 MB, leave out node_modules and .git) and upload it right in the form. Your code stays private and never touches a public git host. Extraction happens in a container without network access; start detection, build and limits are the same as for repositories. The deploy history shows the file's checksum instead of a commit hash.

More git hosts. Besides GitHub, public repositories on GitLab, Codeberg and Bitbucket now work too.

You can switch the source in the settings at any time; a new ZIP replaces the old one on the next deploy.

Also: hosting is now linked from the topbot.gg homepage and header, and the submission summary points out that your bot can run right here.

Profiles, widgets, and a bigger API

Your profile is the new dashboard. Upload a banner, see your numbers at a glance, your bots as cards, and editing and managing now live on one page with sections that switch instantly. Developers are clickable on every bot page and have public profiles.

Reviews carry more weight. Text is now required: stars alone say nothing. The rating distribution shows as bars above the list, a "Helpful" mark sorts the most useful review to the top, and you can delete your own review.

For your website: an embeddable iframe widget with live numbers and a vote button. Code snippet in your profile under "Badges" Badges now render correctly on external sites too.

For your bot: GET /api/v1/search (the real search, with typo tolerance and synonyms) and GET /api/v1/bots/{id}/reviews. The API docs are now front and center at /developers.

Also fixed: uploads tell you exactly what's wrong (4 MB limit). Saving a banner on the edit page works. After a decline, "Rework and resubmit" takes you straight back into the form. And you can enable a vote reminder with one click right after voting.

Teams, commands, online status and one-language submissions

Quite a lot has landed since launch. The parts that matter if you run a bot here:

One language is enough. The descriptions step used to demand German and English, both required. Most abandoned submissions died right there. One complete language now does it; the second is optional, behind a button. If it is missing, we show the other version with a note.

Team management. Owners add maintainers by Discord ID or username (Dashboard → Team). Maintainers can edit the listing and see its statistics.

Edit your listing. Published bots can be edited now: descriptions, images, links and commands go live immediately. The invite, permissions and placement need approval again; your current version stays online until then.

Command list. Discord's API does not hand out another app's commands, so maintain yours in the edit form, one command per line. They show up compactly on your bot page and are searchable.

Online status. Reviewed bots stay in our test server; your bot page now shows whether the bot is up, or when it was last seen online.

Join the server when you submit. Approvals, questions and this changelog run through the Discord server. You can now join it in one step while submitting. Without a shared server our bot cannot notify you.

Also new: a "Reviewed" badge variant, ratings on the cards, share buttons after voting, and drafts can be discarded.