Badges
๐๏ธ A collection of badges for your projects README
Install / Use
/learn @henriquesebastiao/BadgesREADME
๐๏ธ Badges Reference
The most complete Markdown badges collection for your GitHub profile and READMEs
Copy. Paste. Ship. No design skills required. โจ
</div>โจ Why use this repository?
- ๐ Ready-to-use โ copy a single line of Markdown and you're done
- ๐จ Fully customizable โ change colors, styles and icons to match your brand
- ๐ Dynamic badges โ stats that update automatically (stars, downloads, license...)
- ๐ฆ 200+ badges organized by category โ languages, social, OS, streaming and more
- ๐ Powered by Shields.io โ the industry standard for badges
๐ Preview
<div align="center">Languages & Frameworks
Databases & DevOps
Social & Contact
โก Quick Start
Pick any badge below, copy the Markdown snippet, and paste it into your README.md:

Result:
Tip: Press <kbd>Ctrl</kbd>+<kbd>F</kbd> to search for any badge on this page.
๐จ Styles
Choose the visual style that fits your README's vibe:
| Style | Preview | Query param |
|-----------------|---------|-------------|
| flat (default) | |
style=flat |
| flat-square | |
style=flat-square |
| plastic | |
style=plastic |
| social | |
style=social |
| for-the-badge | |
style=for-the-badge |
๐ง Customization
Badges follow a simple URL pattern. Change any part to match your brand:
https://img.shields.io/badge/<LABEL>-<COLOR>?style=<STYLE>&logo=<LOGO>&logoColor=<LOGO_COLOR>
Example โ inverting a badge's colors:
| Variant | Badge | Background | Logo color |
|---------|-------|-----------|------------|
| Dark | |
000000 | white |
| Light | |
ffffff | black |
Find any logo name and its official brand color at simpleicons.org.
๐ Dynamic Badges
These badges update automatically as your project evolves โ perfect for showing real-time stats.
โฌ๏ธ Downloads
| Platform | Preview | URL Syntax |
|----------|---------|-----------|
| Docker Pulls | |
https://img.shields.io/docker/pulls/<user>/<repo> |
| PyPI Downloads | |
https://img.shields.io/pypi/<period>/<package> |
| NPM Downloads | |
https://img.shields.io/npm/<interval>/<package> |
| Flathub | |
https://img.shields.io/flathub/downloads/<package> |
| RubyGems | |
https://img.shields.io/gem/dt/<gem> |
Period values:
dd(daily) ยทdw(weekly) ยทdm(monthly) ยทdy(yearly) ยทd18m(18 months)
โญ Stars & Social Proof
| Description | Preview | URL Syntax |
|-------------|---------|-----------|
| Repo Stars | |
https://img.shields.io/github/stars/<user>/<repo> |
| User Stars | |
https://img.shields.io/github/stars/<user> |
| Followers | |
https://img.shields.io/github/followers/<user> |
| Forks | |
https://img.shields.io/github/forks/<user>/<repo> |
| Docker Stars | |
https://img.shields.io/docker/stars/<user>/<repo> |
๐ท๏ธ Version
| Platform | Preview | URL Syntax |
|----------|---------|-----------|
| GitHub Release | |
https://img.shields.io/github/v/release/<user>/<repo> |
| PyPI | |
https://img.shields.io/pypi/v/<package> |
| NPM | |
https://img.shields.io/npm/v/<package> |
| Flathub | |
https://img.shields.io/flathub/v/<package> |
| RubyGems | |
https://img.shields.io/gem/v/<gem> |
๐ License
| Platform | Preview | URL Syntax |
|----------|---------|-----------|
| GitHub | |
https://img.shields.io/github/license/<user>/<repo> |
| AUR | |
https://img.shields.io/aur/license/<package> |
โค๏ธ Funding
| Platform | Preview | URL Syntax |
|----------|---------|-----------|
| GitHub Sponsors | |
https://img.shields.io/github/sponsors/<user> |
| Liberapay | |
https://img.shields.io/liberapay/patrons/<entity> |
| Open Collective | |
https://img.shields.io/opencollective/backers/<collective> |
๐ Badge Reference
โ๏ธ Contact
| Name | Badge | Markdown |
|------|-------|----------|
| Gmail | |
 |
| WhatsApp | |
 |
| Telegram | |
 |
| Messenger | |
 |
| WeChat | |
 |
| Signal | |
 |
๐ฅ Community & Group
Security Score
Audited on Mar 24, 2026
