TDL

TDL is the official bot for TheDiscordList, a directory of Discord servers and bots. It brings your server's listing into Discord: members upvote it with one command, anyone can post its listing card, and leaderboards show up as a picture. It's free and uses slash commands only.

Add TDL to your server · Website · Support server

Commands

Command	What it does
/upvote	Upvote this server on TheDiscordList
/listing	Post this server's listing card
/leaderboard	Top servers, members site-wide, or this server's members
/stats	A link to the listing's statistics, for whoever manages it

/upvote, /listing and /stats need the server to be listed on TheDiscordList. In a server without a listing, TDL says so and links to the page where an owner can add one.

Upvote without leaving Discord

/upvote casts a vote for the server you're in, the same vote as the Upvote button on its page. Each member can upvote a server once every 12 hours. If you're early, TDL tells you when your next upvote lands. No account is needed beforehand: the vote is tied to your Discord account.

Your listing, as a card

/listing posts the server's card: its summary, categories, member and online counts, votes and when it was last bumped, with a button to its page. /stats doesn't print numbers in a public channel. It answers with a button to the listing's manage page on the website, where the people who manage it see impressions, traffic sources, referrers and bump history.

Leaderboards, drawn for Discord

/leaderboard draws the top 10 as an image with ranks, avatars, bump points, bumps and upvotes. Pick the board:

• This server's members (the default)
• Members site-wide
• Servers

And the period: all time, this year, this month or this week. Boards rank by bump points, then bumps, the same as the website.

Says hello once

When TDL joins a server, it sends the server owner one card in their DMs listing its commands. If the owner's DMs are closed, it posts that card once in the server instead. It posts nothing else on its own, unless an owner turns on cross-posting for their listing's posts on the website.

On the website

Browsing, listing, bumping and your listing's statistics happen on thediscordlist.com, not in the bot. The site also has directories of emojis, stickers, profile pictures and banners. With TDL in your server, the website can:

• Keep your invite link working by creating invites for your listing
• Show more on your listing page, such as your channels, onboarding, staff roles, emojis and stickers
• Add emojis and stickers from the directory to your server, if you give TDL the Manage Expressions permission

Permissions

The invite asks for three: View Channels, Send Messages (for the welcome card when DMs are closed) and Create Invite (for your listing's invite link). TDL doesn't read messages: the only gateway intent it uses is Guilds.

Pricing

The bot is free, with no paid commands and no vote-locked features.