GitHub Stats Badges for Your README
Free, embeddable, auto-updating GitHub stat badges for your profile README — commits, streaks, a contribution graph, and your GitArena rank.
Loading your badges...
GitHub stat badge styles
Three badge styles, five colors, light and dark themes. Badges are SVG images served by GitArena and refresh automatically as you commit — no manual updates, no expiring tokens.
Stats badge
Commits, current streak, and GitArena score for all time, the last year, or the last month.
Compact pill
Your arena rank and score as a small shield, sized to sit in a row of badges at the top of a README.
Monthly contribution graph
Your last 30 days of commits as a compact bar chart.
How to add a badge to your GitHub README
- Enter the arena with your GitHub username (or log in with GitHub to claim your badge).
- Pick a timeframe, theme, and color above, then copy the snippet.
- Paste it into your profile README — the repository named after your username — and commit.
Markdown
[](https://gitarena.dev/u/your-username)Compact pill
[](https://gitarena.dev/u/your-username)Contribution graph
[](https://gitarena.dev/u/your-username)Badges update automatically from your public GitHub activity. Replace your-username with your GitHub username.
Every parameter, layout recipe, and troubleshooting tip is in the complete guide to GitHub stat badges.
GitHub stats badges FAQ
How do I add GitHub stats badges to my README?
Sign in to GitArena with GitHub (or enter your username), pick a badge style, timeframe, theme, and color on this page, then copy the Markdown snippet into your profile README — the repository named after your GitHub username — and commit.
Are GitArena's GitHub stat badges free?
Yes. The badges are completely free. There is nothing to install, no GitHub Action, and no personal access token to manage — each badge is a plain image URL.
Do the badges update automatically?
Yes. Your stats are refreshed from GitHub daily and badge images are cached for about an hour, so your README stays current without you touching it.
What stats can a GitHub badge show?
The stats card shows total commits, your commit streak, your GitArena score, and your leaderboard rank for all time, the last year, or the last month. The compact pill shows rank and score, and the contribution graph shows your last 30 days of activity.
Can I use a dark theme or a different color?
Yes. Every badge supports light and dark themes and five accent colors: purple, blue, green, orange, and pink. Set them with the theme and color query parameters.
How is this different from github-readme-stats?
github-readme-stats cards focus on repositories, stars, and top languages. GitArena badges focus on commit activity: contribution counts, streaks, a 30-day graph, and your rank on a public developer leaderboard. Many profiles use both side by side.
Do the badges work outside GitHub?
Yes. They are standard SVG images at a public URL, so they render in GitLab, Codeberg, and Bitbucket READMEs, on Dev.to and Hashnode, and on personal websites.