Which Tokens
Discord bot token
Logs your bot in to Discord. It comes from the Discord Developer Portal. Discordium never asks for it.
Discordium API token
One per bot or game server listing, created in the listing's Integrations tab. Its scopes decide what it can do: read votes, manage the vote webhook and, for bots, report stats and publish changelog entries.
What a Leaked Token Allows
With your bot token, someone can:
- Do anything your bot's permissions allow, in every server it's in
- Read what the bot can see
- Spam or break Discord's rules in your bot's name, which can get it banned
With your Discordium API token, depending on its scopes, someone can read your listing's votes, report fake stats, change your vote webhook or publish changelog entries.
How To Keep Tokens Secure
1. Keep Tokens Out of Your Code
Read them from environment variables or a secret manager, and keep .env files out of version control.
DISCORDIUM_API_TOKEN=your_token_here2. Grant Only What's Needed
Give a Discordium token only the scopes it uses. For your bot, request only the Discord permissions it needs and avoid Administrator.
3. Regenerate When in Doubt
Regenerating a Discordium token in the listing's Integrations tab stops the old one immediately. A bot token is reset in the Discord Developer Portal under your application's Bot page.
4. Keep Tokens Server-Side
Call the API from your bot or backend. A token in a website's JavaScript can be read by anyone who opens the page.
How Discordium Handles API Tokens
- A token is shown once, when you create or regenerate it. We store only a hash of it.
- A token works only on the listing it was created for, and only within its scopes.
- Regenerating or deleting a token takes effect immediately.
- The Integrations tab shows when the token was last used.
- API requests are rate-limited.
Other Good Habits
- Only give people you trust access to your bot's application and your listing.
- Turn on 2FA for the Discord account that owns your bot.
- Keep libraries such as discord.js or discord.py up to date.
If a Token Leaks
- Regenerate it: in the Discord Developer Portal for a bot token, in the listing's Integrations tab for a Discordium token.
- Check your vote webhook and changelog on Discordium for changes you didn't make.
- Check what your bot did while the token was out: its servers, messages and permissions.
- If someone abused it, report it to Discord Trust & Safety or support@discordium.org.
Last updated: October 2026