Frequently Asked Questions

TopDiscordServers is a directory for Discord servers and bots. Browse by category, compare current votes and activity, then find a community or tool that fits.

Yes. It’s free to browse listings, view details, and vote. Listing owners can also pay for clearly labeled promotional spots, but those ads never change organic rankings.

You don’t need an account to browse or search. Sign in with Discord to vote, claim a listing, or manage your profiles.

Server listings help users discover Discord communities. Bot listings help users find Discord bots and tools. Each listing type has its own categories and profile details.

Yes. The site is designed to work on desktop and mobile browsers, including browsing, searching, and voting flows.

Join our support Discord from the Contact Support links on this page. Include your listing URL and a short description so we can help faster.

Open the Add menu, choose “List Your Server,” and sign in with Discord. Add your server details and submit them for review. Once approved, the listing appears in its categories and tags.

Open the Add menu, choose “List Your Bot,” and sign in with Discord. Add the bot profile, tags, and links, then submit it for review.

Yes. If you’ve claimed the listing, you can update its name, description, categories, tags, image, and links from your account.

Open the server page and click the Join image button to open the server invite.

Join

Open the server page and click the Donate image button, then follow the donation flow shown in the modal.

Donate

New and updated listings can take a few minutes to appear. If yours is still missing, check its links and categories. It may also be waiting for review.

Yes. Claimed server owners can add a Discord webhook from Account > Owned Servers > Webhooks. Each successful vote sends an embed with the voter, server link, and vote time.

In Discord, create a channel webhook and copy the URL. Then open Account > Owned Servers > Webhooks, paste the URL, and save. Use Test to confirm your channel receives the embed.

Each server can send up to five test embeds. The test button shows how many sends remain. Tests do not create votes or change ranking.

Only the authenticated owner of a claimed server can view, replace, test, or remove that server’s webhook. Keep webhook URLs private because anyone with the URL can post to its Discord channel.

Most issues come from an invalid/expired webhook URL, deleted webhook, or changed channel permissions. Re-save the webhook URL and send a test embed. If tests fail, create a new Discord webhook and replace the old URL.

Alerts are usually sent within seconds after a successful vote is recorded. Short delays can happen during peak traffic or temporary Discord webhook issues.

Community votes drive the rankings. We also check listing quality and consistency. For servers, that includes activity and invite health. For bots, it includes profile quality and recent voting.

You can vote for each listing once per voting window. We filter automated votes, duplicate accounts, and other abuse to keep rankings fair.

You can’t buy votes or an organic rank. We remove purchased and artificially inflated votes. Paid promotional spots are labeled and shown separately from vote-based rankings.

A vote may be rejected if you are still in cooldown, not signed in correctly, or the vote was flagged by anti-abuse checks. Try again after the cooldown window.

When downvoting is enabled for a listing type, downvotes are included in ranking calculations along with quality and abuse filters.

We use automated checks and manual review to detect spam, botting, duplicate accounts, and suspicious patterns. Invalid votes can be removed from totals.

TDS Cash is a virtual currency used for services on TopDiscordServers.com, including server boosts. You can see your balance in your account menu and account dashboard.

You can earn TDS Cash through verified vote rewards, approved platform stats contributions, valid bug reports, and useful suggestions accepted by our team. Rewards are discretionary and may vary by contribution type.

No. Rewards are granted for valid, original, and actionable submissions. Duplicate, low-quality, or non-actionable reports may receive no reward.

When you click the server promotion button, the dialog shows a TDS Cash card (for your wallet or server wallet) before you choose Boost or Bump. You can also view your balance in your account menu and dashboard.

The purchase is declined and your boost or bump is not changed. Add more balance through normal voting activity, then try again.

No. TDS Cash is account-bound and currently cannot be transferred between users.

Open your server page and click the Boost image button. In the dialog, choose your payment source, then choose Boost. You will see the duration cards (1 day, 7 days, 30 days) and can tap one to continue.

Boost

Use the large server action image button labeled Boost on the server page header or action stack. It opens the promotion dialog where you choose wallet source and duration.

Current boost pricing is $7.00 TDS Cash for 1 day, $14.00 TDS Cash for 7 days, and $30.00 TDS Cash for 30 days. One TDS Cash equals $1.00.

The new boost time is added to the existing active boost window. Your server keeps its boosted position while the combined window remains active.

Yes, if you are the claimed owner of that server. The first promotion step asks you to choose Your Wallet or Server Wallet before continuing.

No. Boosting is a clearly labeled promotional placement and does not rewrite real vote totals. Organic ranking still depends on actual voting activity.

A bump refreshes a currently boosted server so it returns to the top of boosted listings by recency.

Open your server page and click the promotion image button. In the dialog, pick your wallet source, then choose Bump. You will see the Bump card with the trend-up icon and the text “Bump this server back to the top.” Tap it to confirm.

Bump

No. Bumping only refreshes boosted position. It does not add days to boosted time.

No. Bump is only available for servers with an active boost window. If the boost has expired, purchase a new boost first.

Bump pricing is configured as a fraction of the 1-day boost price and is shown directly in the Bump flow before you confirm.

You can bump as often as needed while your server is actively boosted and you have enough TDS Cash in the selected wallet source.

Use the Discord Bot Vote Command Docs page at /bot-vote-docs for language examples (Node.js, Python, Java, C#, PHP, Go, and cURL), payload format, and error handling guidance.

Open the API tester at /bot-vote-endpoint. It is a mock-only JSON tester with preset success and failure responses so you can validate request formatting and bot-side error handling.

Send a POST request to /api/external/discord-servers/{discordServerId}/vote with discord_user_id and direction in JSON. Direction supports up or down, and aliases like upvote/downvote and 1/-1 are normalized.

You can authenticate with Authorization: Bearer YOUR_API_KEY, X-API-Key: YOUR_API_KEY, or api_key in the JSON body. Keep API keys in environment variables and never expose them in client-side code.

Set TDS_API_KEY to your external API key and TDS_DISCORD_SERVER_ID to your Discord server ID (guild ID). This keeps your command code simple and makes key rotation easier.

Handle 401 for missing/invalid API key, 403 for unregistered users, 404 for unknown server ID, 422 for validation errors, and 429 for cooldown windows. For 429 responses, show retryAfterHuman in your bot message when available.

It is a free tool at /embed-builder that lets you design Discord embeds visually with a live preview, then copy ready-to-use code for your bot or webhook. No coding or account is required.

You can copy code for discord.js (Node.js), discord.py and py-cord (Python), disnake, and nextcord, plus raw embed JSON for Discord webhooks.

Yes. The description field renders Discord markdown in the live preview, including bold, italic, underline, strikethrough, inline code, code blocks, and spoilers.

No. The tool runs in your browser and is free to use without signing in. You just design your embed and copy the generated code.

No. Embed content is processed locally in your browser to build the preview and code output. We do not store the text, links, or images you enter.

Copy the JSON output and send it in the embeds array of a webhook POST request. This lets you post a branded embed to a channel without running a bot.

A verified listing passed our checks for a working invite, recent activity, and ownership details. For bots, we also review the submitted profile.

We watch invite health, activity patterns, duplicate submissions, and community reports. We lower or remove stale, misleading, and low-quality listings.

Use the report option on any listing page or contact support with the listing name, URL, and reason for the report.

Claim your listing first, complete your profile details, and ensure your invite and links are valid. Our team reviews eligible listings for trust and quality signals.

Review time varies by queue volume and listing quality, but most checks are completed within a few days.

Yes. Verification may be removed if a listing becomes misleading, inactive, unsafe, or no longer meets trust requirements.

Sign in through Discord. We only ask for the permissions needed to identify your account and help you claim or manage listings.

Open your Account menu and use Delete Account. You must type DELETE one letter at a time in the confirmation boxes. Once confirmed, your account is removed from active access and your listing ownership is released.

Account deletion cannot be undone from the website. If you are in the official TopDiscordServers Discord server, we also attempt to remove you automatically. We may retain limited records where required for security, abuse prevention, legal compliance, or accounting.

Deleted accounts are treated as final for normal user access. If you think the deletion was accidental, contact support and we will review your request.

You can read them at /terms-of-use, /privacy-policy, and /community-rules. These policies explain account deletion, data retention, voting rules, listing standards, and enforcement.

Yes. All payments for promotional features are processed through trusted third-party providers using encrypted connections. We never store full payment details on our servers.

For security, sessions can expire after inactivity or account changes. Sign in again with Discord to continue.

Your account identity comes from Discord. Update your Discord profile, then sign out and back in to refresh your synced details.

Promotional purchases are generally final once delivered. If there was a technical issue with delivery, contact support with transaction details for review.