Skip to content

Customization Parameters

Rangga Fajar Oktariansyah edited this page Mar 31, 2026 · 1 revision

Full Customization Parameters

Below are all available URL parameters for customizing the stats card. All parameters are optional and can be combined freely.

Color Parameters

Parameter Description Type Default
title_color Color of the card title hex color 2f80ed
text_color Color of the stat text hex color 434d58
icon_color Color of the icons next to stats hex color 4c71f2
border_color Color of the card border hex color e4e2e2
bg_color Background color (solid or gradient) hex color or gradient fffefe
stroke_color Stroke color around the profile picture hex color border_color
username_color Color of the username below the picture hex color text_color

Appearance Parameters

Parameter Description Type Default
theme Name of a built‑in theme enum default
title Custom title (URL‑encoded) string null
locale Display language enum en
border_width Border width in pixels number 1
border_radius Corner radius in pixels number 4.5
format Output format (svg, png, json, xml) enum svg
disabled_animations Disable CSS animations boolean false
hide_border Hide the outer card border boolean false
hide_stroke Hide the stroke around the profile picture boolean false
revert Flip layout (stats left, picture right) boolean false
photo_quality Profile picture quality (1–100) number 15
photo_resize Profile picture size in pixels number 150

Content Parameters

Parameter Description Type Default
hide Stats to hide (comma‑separated) string null
show Additional stats to show (comma‑separated) string null

Values for hide

Value Description
repos Number of repositories
stars Total stars received
forks Total forks
commits Commits this year
prs Pull requests created
prs_merged Merged pull requests
issues Issues opened
contributed Contributions to other repos

Values for show

Value Description
reviews Number of code reviews
issues_closed Issues closed
discussions_started Discussions started
discussions_answered Discussions answered

Example Usage

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&title_color=ff0000&text_color=00ff00&icon_color=0000ff&bg_color=ffffff&border_radius=10&hide=forks,issues)

Advanced Usage

Gradient Backgrounds

Create a gradient background using the bg_color parameter with the format angle,start,end:

  • angle – Gradient angle in degrees (0–360)
  • start – Starting color (hex without #)
  • end – Ending color (hex without #)
![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&bg_color=30,e96443,904e95&title_color=fff&text_color=fff&icon_color=fff)

Transparent Theme & Alpha Channel

Using the transparent theme

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=transparent)

Using an 8‑digit hex with alpha

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&bg_color=00000000)

00000000 means fully transparent. You can also use partial transparency, e.g., bg_color=00000080 for 50% transparency.

GitHub Theme Context

GitHub supports showing different images for light and dark modes using #gh-dark-mode-only and #gh-light-mode-only tags.

[![GitHub Stats - Dark](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=dark#gh-dark-mode-only)](https://github.com/FajarKim/github-readme-profile#gh-dark-mode-only)

[![GitHub Stats - Light](https://gh-readme-profile.vercel.app/api?username=FajarKim&theme=default#gh-light-mode-only)](https://github.com/FajarKim/github-readme-profile#gh-light-mode-only)

Dark mode users will see the dark theme card, while light mode users will see the default theme card.

Hiding Individual Stats

Use the hide parameter to exclude stats you don’t want to show. Separate values with commas and no spaces.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&hide=repos,forks,prs_merged)

Showing Additional Stats

Use the show parameter to display extra metrics beyond the default set.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&show=reviews,issues_closed,discussions_started,discussions_answered)

Custom Title

The title parameter lets you replace the card title. The value must be URL‑encoded.

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&title=My%20GitHub%20Journey)

Disabling Animations

If you prefer a static card without animations, use disabled_animations=true:

![GitHub Stats](https://gh-readme-profile.vercel.app/api?username=FajarKim&disabled_animations=true)

Clone this wiki locally