Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/discordplace/discord.place/llms.txt

Use this file to discover all available pages before exploring further.

The bots directory is discord.place’s catalog of Discord bots. You can browse thousands of bots by category, search by keyword, or sort by votes to find the right bot for your server. Bot developers can list their bots, receive vote notifications via webhook, and post live stats through the API.

​
Browsing bots

The bots listing page lets you search and filter the catalog in several ways:
  • Search — enter a bot name or keyword in the search bar
  • Categories — filter by tags such as Moderation, Music, Fun, Utility, and more
  • Sorting — order results by vote count, newest, or most servers
Each bot listing shows the bot’s name, short description, category tags, vote count, server count, and command count.

​
Adding your bot

You must be a member of the discord.place Discord server before submitting a bot. You also need to be the verified owner of the bot application in Discord.
1

Join the discord.place server

Join the official discord.place Discord server. Your membership is verified during submission.
2

Go to the bots page

Navigate to discord.place/bots and click Add your bot.
3

Enter your bot's details

Provide the following information:
  • Bot ID — the application/user ID of your Discord bot
  • Short description — a brief one-liner shown in listings
  • Description — a full Markdown description of your bot’s features
  • Invite URL — a valid Discord authorization URL for your bot
  • Categories — one or more tags that describe your bot
  • Webhook URL (optional) — a URL to receive vote notifications
  • Webhook token (optional) — a secret token sent with webhook payloads
4

Submit for review

Click Submit. Your bot enters a review queue. The discord.place team will review and approve or deny it. You will be notified in the Discord server.
If your bot is denied, you must wait 6 hours before resubmitting the same bot.

​
Voting

Any logged-in user can vote for a bot once every 24 hours. The vote count is displayed on the bot’s listing page and increments with each vote. Votes help surface popular bots in search results and rankings. If you have configured a webhook URL on your bot listing, discord.place will send a POST request to that URL each time someone votes. See Vote Webhooks for the payload format.

​
Reviews

Users can leave a star rating and a text review (64–256 characters) on any approved bot. Reviews are moderated before appearing publicly. Each user can submit one review per bot.

​
Bot stats

Your bot listing displays two live statistics:
StatDescription
Server countThe number of servers your bot is in
Command countThe number of slash commands your bot exposes
You can update these stats in two ways:
  • API — send a PATCH request from your bot’s process using your API key. See Update Bot Stats.
  • Dashboard — update the values manually from your bot’s manage page on discord.place.
The server count you submit via the API is validated against Discord’s approximate guild count. Values that differ too far from the real count are rejected.

​
API integration

Generate an API key from your bot’s manage page on discord.place to authenticate stat update requests.

Update Bot Stats

Post server count and command count from your bot’s process.

Check Vote

Check whether a specific user has voted for your bot.

Vote Webhooks

Receive a POST request every time someone votes for your bot.

Authentication

Learn how to generate and use your bot’s API key.

Build docs developers (and LLMs) love

Get started for freeTalk to us