> ## 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.

# 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.

<Tabs>
  <Tab title="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](#adding-your-first-bot-listing) to begin.
  </Tab>

  <Tab title="Server owner">
    If you run a Discord server and want to grow your community, head to [Adding your first server listing](#adding-your-first-server-listing) to get your server listed.
  </Tab>

  <Tab title="Community member">
    If you're looking for bots, emojis, templates, or servers to join, start at [Explore the platform](#explore-the-platform) to browse everything available.
  </Tab>
</Tabs>

## 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.

<Steps>
  <Step title="Visit discord.place">
    Open [discord.place](https://discord.place) in your browser. The homepage displays featured bots, trending servers, popular emojis, and community highlights.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  discord.place uses Cloudflare Turnstile on certain actions to confirm you're human. If you see a verification prompt, complete it to proceed.
</Note>

***

## Explore the platform

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

<CardGroup cols={2}>
  <Card title="Bots" icon="robot" href="https://discord.place/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.
  </Card>

  <Card title="Emojis" icon="face-smile" href="https://discord.place/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.
  </Card>

  <Card title="Servers" icon="compass" href="https://discord.place/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.
  </Card>

  <Card title="Profiles" icon="user" href="https://discord.place/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`.
  </Card>

  <Card title="Templates" icon="rectangle-list" href="https://discord.place/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.
  </Card>

  <Card title="Sounds" icon="waveform" href="https://discord.place/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.
  </Card>

  <Card title="Themes" icon="palette" href="https://discord.place/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).
  </Card>

  <Card title="Blog" icon="newspaper" href="https://discord.place/blogs">
    Read platform announcements, community spotlights, and guides published by the discord.place team.
  </Card>
</CardGroup>

***

## 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](https://discord.com/developers/applications))
* 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

<Steps>
  <Step title="Navigate to the bots section">
    Go to [discord.place/bots](https://discord.place/bots) and click **Add your bot** at the top of the page.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Submit for review">
    Click **Submit**. Your bot enters the review queue. A moderator will check that it meets all requirements before approving.
  </Step>
</Steps>

### Review requirements

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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="Bot must support slash commands">
    All listed bots are required to implement Discord's slash command system for consistent user experience.
  </Accordion>

  <Accordion title="No copied or reposted bots">
    Direct forks of existing listed bots without meaningful additions will be declined to avoid duplicates.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Accurate and honest descriptions">
    Misleading or inaccurate descriptions are grounds for rejection. Describe your bot's actual functionality clearly.
  </Accordion>

  <Accordion title="No security vulnerabilities">
    Bots with known exploits or security vulnerabilities will be denied until the issues are resolved.
  </Accordion>
</AccordionGroup>

<Note>
  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.
</Note>

***

## 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

<Steps>
  <Step title="Navigate to the servers section">
    Go to [discord.place/servers](https://discord.place/servers) and click **Add your server**.
  </Step>

  <Step title="Select your server">
    You'll see a list of servers where you have the Manage Server permission. Select the server you want to list.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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}`.
  </Step>

  <Step title="Submit for review">
    Click **Submit**. Unlike bot listings, server listings go through an automated eligibility check and a shorter review process.
  </Step>
</Steps>

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

***

## 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.

<Steps>
  <Step title="Go to your bot's manage page">
    Navigate to [discord.place/bots](https://discord.place/bots), find your bot, and click **Manage** on the listing.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

***

## 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:

```bash theme={null}
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:

```javascript theme={null}
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
  })
});
```

<Tip>
  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.
</Tip>

<Note>
  For full API reference documentation including authentication details, rate limits, and vote webhook payloads, see the [API Reference](/api-reference/overview).
</Note>