Quickstart

Get started with discord.place — browse the platform, create an account, and add your first bot or server listing.

discord.place is a comprehensive hub for everything Discord. Whether you’re a bot developer wanting to grow your user base, a server owner looking for new members, or a community member searching for the perfect emoji pack or server template — this guide walks you through your first steps on the platform.

Bot developer

If you maintain a Discord bot, you’ll want to create a bot listing, get an API key, and start pushing live stats. Jump to Adding your first bot listing to begin.

Server owner

If you run a Discord server and want to grow your community, head to Adding your first server listing to get your server listed.

Community member

If you’re looking for bots, emojis, templates, or servers to join, start at Explore the platform to browse everything available.

Log in with Discord

discord.place uses Discord OAuth for authentication. No separate account creation is needed — your existing Discord identity is all you need.

1. Visit discord.place

   Open discord.place in your browser. The homepage displays featured bots, trending servers, popular emojis, and community highlights.

2. Click Log in

   Click the Log in button in the top-right corner of the navigation bar. You’ll be redirected to Discord’s authorization page.

3. Authorize the application

   Discord will ask you to grant discord.place access to your account. The platform requests the identify, email, and guilds scopes — these are used to verify your identity, send platform notifications, and let you manage listings for servers you own.

   Click Authorize to continue.

4. Return to discord.place

   After authorizing, you’ll be redirected back to discord.place and logged in. Your Discord avatar and username appear in the navigation bar.

discord.place uses Cloudflare Turnstile on certain actions to confirm you’re human. If you see a verification prompt, complete it to proceed.

---

Explore the platform

discord.place is organized into distinct sections, each serving a different part of the Discord community.

Bots

Browse thousands of Discord bots across categories including Moderation, Utility, Fun & Games, Music, Economy, Roleplay, Technology, Art & Design, Virtual Assistants, Social Media Integration, and Anime & Manga. Each listing shows server count, vote count, and a full description.

Emojis

Find and download custom emojis and emoji packages. Categories include Gaming, Anime, Memes, Pepe, Pixel Art, Cute, Logos, Utility, and Animated. Packages group 4–9 related emojis together for easy bulk use.

Servers

Discover Discord servers to join, filtered by category: Gaming, Anime, Public, Community, Music, Art, Programming, Science, Technology, Education, Language, and more. Sort by member count, votes, boosts, or newest.

Profiles

Create a public profile page that showcases your Discord identity. Profiles support up to 8 social links — including Instagram, X, GitHub, Twitch, YouTube, LinkedIn, Reddit, Mastodon, Bluesky, and more. Custom profile URLs are available at dsc.lat, dsc.gay, dsc.wtf, and dsc.baby.

Templates

Share and discover Discord server templates across categories like Chat, Design, Music, Education, Gaming, Anime, Tech, Roleplay, and Event. Each template can have up to 3 categories and a description of 32–256 characters.

Sounds

Browse sounds for use in Discord voice channels. Categories include Memes, Loud, NSFW, and Other. All sounds are available as MP3 files served from the discord.place CDN.

Themes

Explore visual themes contributed by the community. Available in styles including Gradient, Light, Dark, and a range of color-based themes (Red, Orange, Yellow, Green, Blue, Purple, Pink).

Blog

Read platform announcements, community spotlights, and guides published by the discord.place team.

---

Adding your first bot listing

To list your bot on discord.place, it must be publicly inviteable, online, and functional. The review team checks each submission before it goes live.

What you’ll need

Before submitting, prepare the following:

• Your bot’s application ID (from the Discord Developer Portal)
• A short description (16–150 characters) summarizing what your bot does
• A full description (32–8,192 characters) with detailed information — this field supports Markdown
• At least one category from: Moderation, Utility, Fun & Games, Music, Economy, Roleplay, Technology, Art & Design, Virtual Assistants, Social Media Integration, Anime & Manga, or Other
• Up to 4 extra owners (optional) — other Discord users who co-own the bot
• A support server invite (optional but recommended) — must be a valid Discord webhook URL

Submit your bot

1. Navigate to the bots section

   Go to discord.place/bots and click Add your bot at the top of the page.

2. Enter your bot's application ID

   Paste your bot’s Discord application ID into the field. discord.place fetches the bot’s name and avatar from Discord automatically.

3. Fill in the listing details

   Write a short description (16–150 characters) that appears in search results and category pages. Then write a full description (32–8,192 characters) — use Markdown to format commands, features, and links clearly. Select the categories that best describe your bot.

4. Submit for review

   Click Submit. Your bot enters the review queue. A moderator will check that it meets all requirements before approving.

Review requirements

The review team will reject submissions that don’t meet these standards:

Bot must be online and inviteable

Your bot must be running and joinable via a public invite link at the time of review. Offline or uninvitable bots are rejected.

Bot must support slash commands

All listed bots are required to implement Discord’s slash command system for consistent user experience.

No copied or reposted bots

Direct forks of existing listed bots without meaningful additions will be declined to avoid duplicates.

No Discord Terms of Service violations

Bots that violate Discord’s Terms of Service — including those that self-bot, mass DM, or engage in other prohibited behavior — will not be accepted.

Accurate and honest descriptions

Misleading or inaccurate descriptions are grounds for rejection. Describe your bot’s actual functionality clearly.

No security vulnerabilities

Bots with known exploits or security vulnerabilities will be denied until the issues are resolved.

You’ll receive a notification through the platform when your bot is approved or if it’s denied with a reason. Denied listings can be re-submitted after addressing the feedback.

---

Adding your first server listing

Server listings help community members discover your Discord server. Before listing, your server must meet several eligibility criteria that are automatically verified.

Server eligibility requirements

discord.place checks the following automatically when you attempt to list:

Requirement	Description
Minimum member count	Your server must have enough members to be listed
Minimum server age	The server must be old enough to prevent spam listings
Server icon	Your server must have a custom icon set
Two-factor authentication	Server 2FA must be enabled
Community server	The server must have Discord’s Community feature enabled
No NSFW content	NSFW channels must not be present or must be properly gated

Submit your server

1. Navigate to the servers section

   Go to discord.place/servers and click Add your server.

2. Select your server

   You’ll see a list of servers where you have the Manage Server permission. Select the server you want to list.

3. Fill in the listing details

   Write a description (up to 256 characters) that will appear on your server’s listing page. Add up to 5 keywords (each up to 32 characters) that help users find your server. Select the most relevant category — options include Gaming, Anime, Public, Community, Music, Art, Programming, Science, Technology, Education, Language, and Other.

4. Optionally add a webhook

   You can connect a Discord webhook URL to receive notifications when users vote for your server. The webhook must be a valid Discord webhook URL in the format https://discord.com/api/webhooks/{id}/{token}.

5. Submit for review

   Click Submit. Unlike bot listings, server listings go through an automated eligibility check and a shorter review process.

Encourage your existing members to vote for your server on discord.place. Servers with more votes appear higher in search results and category pages.

---

Getting an API key for your bot

Once your bot listing is approved, you can generate an API key to programmatically update your bot’s stats — server count, command count, and more.

1. Go to your bot's manage page

   Navigate to discord.place/bots, find your bot, and click Manage on the listing.

2. Open the API keys tab

   On the bot management page, click the API keys tab. This tab is only visible to the bot’s owner and any co-owners you’ve added to the listing.

3. Create a new API key

   Click Create API key. Give the key a name to identify its usage (for example, production or stats-updater). The key will be shown once — copy it immediately and store it securely.

Your API key grants full access to update your bot’s listing data. Treat it like a password — never commit it to source control or expose it in client-side code.

---

Making your first API call

With your API key in hand, you can update your bot’s stats using the discord.place REST API. The base URL for all API requests is https://api.discord.place.

Update bot stats

Send a PATCH request to update your bot’s server count and command count:

curl -X PATCH https://api.discord.place/bots/{BOT_ID}/stats \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"server_count": 1500, "command_count": 100}'

Replace {BOT_ID} with your bot’s Discord application ID and YOUR_API_KEY with the key you generated above.

Request body

Field	Type	Required	Description
server_count	integer	Yes	The number of servers your bot is currently in
command_count	integer	No	The total number of slash commands your bot has registered

Response

A successful update returns 200 OK with { "success": true }. If the server_count you provide differs from the actual count by more than the configured threshold (at least 50, or 10% of the actual count — whichever is larger), the request will be rejected to prevent inflated stats.

Using a library

If you’re using Node.js, you can use fetch directly:

await fetch(`https://api.discord.place/bots/${process.env.BOT_ID}/stats`, {
  method: 'PATCH',
  headers: {
    'Authorization': process.env.DISCORD_PLACE_API_KEY,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    server_count: client.guilds.cache.size,
    command_count: client.application.commands.cache.size
  })
});

The stats endpoint allows only 2 requests per 120 minutes. Update stats on a scheduled interval (e.g., every hour) rather than on every guild event.

For full API reference documentation including authentication details, rate limits, and vote webhook payloads, see the API Reference.