Stats Card
The stats card shows a summary of your GitHub activity: stars earned, commits, pull requests, issues, contributions and an overall rank.
Hiding individual stats
Section titled “Hiding individual stats”You can pass a query parameter &hide= to hide any specific stats with comma-separated values.
Options:
&hide=stars,commits,prs,issues,contribs
Showing additional individual stats
Section titled “Showing additional individual stats”You can pass a query parameter &show= to show any specific additional stats with comma-separated values.
Options:
&show=contributions,reviews,discussions_started,discussions_answered,prs_merged,prs_merged_percentage,prs_authored,prs_commented,prs_reviewed,issues_authored,issues_commented
Showing icons
Section titled “Showing icons”To enable icons, you can pass &show_icons=true in the query param, like so:
Filtering by repository and owner
Section titled “Filtering by repository and owner”To compute your stats for only a specific repository, you can pass a query parameter &repo=<user_or_organization>/<repository>. You can also specify a comma-separated list of multiple repositories, e.g. &repo=userA/repositoryA,organizationB/repositoryB. And you can select all repositories owned by specific organizations or users by providing a comma-separated list of owners via the owner query parameter, e.g. &owner=userA,organizationB,organizationC. The repo and owner filters are supported by the following items: commits (when used with &include_all_commits=true), prs_authored, prs_commented, prs_reviewed, issues_authored and issues_commented. Note that most of these items are not displayed by default, but you can enable them individually.
(Some of these mentioned items are similar to other items which are included by default, e.g. issues_authored is similar to issues. The difference is how these values are fetched - via GraphQL or via REST API. The default items use GraphQL, but filtering by repository works better via REST API.)
Alternatively, you can use the role parameter to specify a comma-separated list of roles. The stats will include all repositories in which the user has the specified role. By default, only repositories where the user is OWNER will be included, but you could e.g. set &role=OWNER,ORGANIZATION_MEMBER,COLLABORATOR. The role parameter is supported by all items except the following: commits (when used with &include_all_commits=true), prs_authored, prs_commented, prs_reviewed, issues_authored and issues_commented.
Showing commits count for specified year
Section titled “Showing commits count for specified year”You can specify a year and fetch only the commits that were made in that year by passing &commits_year=YYYY to the parameter.
Options
Section titled “Options”You can customize the appearance and behavior of the stats card using the common options and the exclusive options listed in the table below.
| Name | Description | Type | Default value |
|---|---|---|---|
hide | Hides the specified items from stats. | string (comma-separated values) | null |
hide_title | Hides the title of your stats card. | boolean | false |
card_width | Sets the card’s width manually. | number | 500px (approx.) |
hide_rank | Hides the rank and automatically resizes the card width. | boolean | false |
rank_icon | Shows alternative rank icon (i.e. github, percentile or default). | enum | default |
show_icons | Shows icons near all stats. | boolean | false |
include_all_commits | Count total commits instead of just the current year commits. | boolean | false |
line_height | Sets the line height between text. | integer | 25 |
exclude_repo | Excludes specified repositories. Affects only the count for “Total Stars Earned”. | string (comma-separated values) | null |
repo | Count only stats from the specified repositories. Affects only certain items. | string (comma-separated values) | null |
owner | Count only stats from the specified organizations or users. Affects only certain items. | string (comma-separated values) | null |
role | Include repositories where the user has one of the specified roles (OWNER, ORGANIZATION_MEMBER, COLLABORATOR). | string (comma-separated values) | OWNER |
custom_title | Sets a custom title for the card. | string | <username> GitHub Stats |
text_bold | Uses bold text. | boolean | true |
disable_animations | Disables all animations in the card. | boolean | false |
ring_color1 | Color of the rank circle. | string (hex color) | 2f80ed |
number_format | Switches between two available formats for displaying the card values: short (i.e. 6.6k) and long (i.e. 6626). | enum | short |
number_precision | Enforce the number of digits after the decimal point for short number format. Must be an integer between 0 and 2. Will be ignored for long number format. | integer (0, 1 or 2) | null |
show | Shows additional items on the stats card (i.e. contributions, reviews, discussions_started, discussions_answered, prs_merged or prs_merged_percentage. And the following, which support the repo and owner filters: prs_authored, prs_commented, prs_reviewed, issues_authored or issues_commented). | string (comma-separated values) | null |
commits_year | Filters and counts only commits made in the specified year. | integer (YYYY) | <current year> (one year to date) |
1: Supports light and dark mode via ring_color_light and ring_color_dark.