Promote

Badges

Show off your listing wherever people find your bot. A badge shows your category rank, rating or votes, updates on its own, and links back to your page on tglist.ing, where visitors can vote.

Get your badge

Open Dashboard → your bot and scroll to Badges. Pick what it shows, its size and theme, then copy the Markdown, HTML or Telegram snippet. Badges are available once your listing is live in the directory.

Badge URL

GET https://tglist.ing/badge/your-bot-username.svg?type=rank&theme=dark&style=large

The path is your listing's slug, the same as in /bots/your-bot-username. Every parameter is optional.

Parameter	Values
type	`auto` (default) shows your rank while you're in your category's top 10, otherwise your votes, or your rating if you have no votes yet. Or pick one: `rank`, `rating`, `votes`.
theme	`light` (default) or `dark`.
style	`flat` (default), a 20px badge, or `large`, a card with your bot's name.

Your rank is your place in your category in the directory's default order, by votes, so it matches what visitors see on the category page.

Embed it

GitHub README (Markdown)

[![Example Bot on tglist.ing](https://tglist.ing/badge/example-bot.svg)](https://tglist.ing/bots/example-bot?utm_source=badge&utm_medium=readme)

Website (HTML)

<a href="https://tglist.ing/bots/example-bot?utm_source=badge&utm_medium=website">
  <img src="https://tglist.ing/badge/example-bot.svg" alt="Example Bot on tglist.ing" height="20">
</a>

Telegram doesn't show SVG images, so for a /start message, a pinned message or a channel post use the Telegram snippet: a line with your current numbers and a link to your listing.

The Telegram text is a snapshot of your numbers when you copy it. The image badges update by themselves.

Share cards

A share card is a big picture of your best claim, like #2 trending this week or #3 in Productivity, with your bot's name, rating and votes. Open Dashboard → your bot → Share card to pick a stat and a theme, then download the PNG, share to Telegram, post on X or copy the link. Owners with a public profile get one too, under Dashboard → Profile, showing their place on the owner leaderboard.

The shared link opens your listing, and Telegram and X show the card as its preview. The best stat is your trending rank while you're in the top 10 this week, then your category rank in the top 10, then your rating, then your votes. A card only offers stats that are true right now.

GET https://tglist.ing/card/bot/your-bot-username.png?stat=trending&theme=dark

Parameter	Values
stat	`auto` (default), `trending`, `category`, `rating` or `votes`. A stat you don't qualify for falls back to `auto`.
theme	`light` (default) or `dark`.
download	`1` downloads the image instead of showing it.

Telegram and X keep a link's preview for a long time. Share links carry the week (w=), so a link shared next week gets a fresh card, and older posts keep the card from when they were shared.

Good to know

Badges are cached for up to an hour, so a new vote or review can take a while to show. GitHub caches images too.
Snippet links carry utm_source=badge and a utm_medium (readme, website or telegram), so you can tell where visitors came from.
If your listing is hidden, suspended or not approved yet, the badge says not listed instead of breaking your page.
Need something else? See Vote rewards to reward users who vote.