Loading...
Back to Documentation
Bot Badge
Show off your TopBotList presence by embedding a badge on your website, GitHub README, or documentation.
Badge Styles
Choose from three badge styles to match your site's design.
Flat (Default)
Classic shields.io style badge
https://topbotlist.net/api/bots/YOUR_BOT_ID/badgeFlat Square
Sharp corners for a modern look
https://topbotlist.net/api/bots/YOUR_BOT_ID/badge?style=flat-squareFor The Badge
Larger, all-caps style
https://topbotlist.net/api/bots/YOUR_BOT_ID/badge?style=for-the-badgeEmbed Code
Copy one of these code snippets to add the badge to your site. Replace YOUR_BOT_ID with your actual Discord bot ID.
HTML
<a href="https://topbotlist.net/bots/YOUR_BOT_ID"> <img src="https://topbotlist.net/api/bots/YOUR_BOT_ID/badge" alt="View on TopBotList"> </a>
Markdown (GitHub README)
[](https://topbotlist.net/bots/YOUR_BOT_ID)
BBCode (Forums)
[url=https://topbotlist.net/bots/YOUR_BOT_ID][img]https://topbotlist.net/api/bots/YOUR_BOT_ID/badge[/img][/url]
Customization
You can customize the badge label using the label query parameter.
Custom Label Example
https://topbotlist.net/api/bots/YOUR_BOT_ID/badge?label=My%20BotBadge Status Colors
The badge automatically displays different statuses based on your bot's achievements:
Certified - Your bot is TopBotList certified
X servers - Shows server count when over 1,000
X votes - Shows vote count when over 100
Listed - Default status for published bots
Why Add a Badge?
- ✓ Build trust - Show users your bot is listed on a reputable directory
- ✓ Increase votes - Make it easy for users to find and vote for your bot
- ✓ Track growth - Badge updates automatically as your bot grows
- ✓ SEO benefit - Backlinks from your site help your listing rank better