GitHub Profile StatsView on GitHub

GitHub Stats for Your README

One line in your README — that's it. Your stats card stays up to date automatically. Pick a theme, hide what you don't need, and you're done.

default

Quick Start

GitHub displays a special README on your profile when you create a repo with the same name as your username.

Already have a profile README? Skip to step 2.

Edit the README.md in your profile repo and paste:

![GitHub Stats](https://ghstats.dev/api/card?username=YOUR_USERNAME)

Want a different look? Add &theme=tokyonight or use the editor below to customise everything.

Customise your card and copy the embed code.

GitHub Username

Custom Title (optional)

Border Radius: 4.5

Show IconsShow RingHide BorderHide Title

Hide Stats

Live Preview

Enter a username to see the preview

Theme

Markdown

![GitHub Stats](https://ghstats.dev/api/card?username=octocat)

HTML

<img src="https://ghstats.dev/api/card?username=octocat" alt="GitHub Stats" />

Everything you can pass as a URL query parameter.

Parameter	Type	Default	Description
`username`	string	`required`	GitHub username to fetch stats for
`theme`	string	`"default"`	Theme preset name (see Themes below)
`bg`	hex	`—`	Custom background color (without #)
`text`	hex	`—`	Custom text color (without #)
`title_color`	hex	`—`	Custom title color (without #)
`icon_color`	hex	`—`	Custom icon color (without #)
`border_color`	hex	`—`	Custom border color (without #)
`hide_border`	boolean	`false`	Set to "true" to remove the border
`hide_title`	boolean	`false`	Set to "true" to remove the title
`show_icons`	boolean	`true`	Set to "false" to hide stat icons
`show_ring`	boolean	`true`	Set to "false" to hide the activity ring
`hide`	string	`—`	Comma-separated stat keys to hide
`border_radius`	number	`4.5`	Card corner radius (0–50)
`custom_title`	string	`—`	Override the card title text

Pass a comma-separated list of keys to the hide parameter:

?hide=stars,issues,followers