How to Add a Profile Views Counter to Your GitHub Profile README

The profile views counter is a badge hosted at komarev.com that tracks page loads using a pixel-counting approach similar to analytics trackers. Each time your README renders — whether from someone visiting your profile, a search engine indexing the page, or a bot crawling GitHub — the counter increments. The badge updates in real time and displays the running total.

Because the count includes automated and bot traffic, it is not a precise measure of human visitors. Sophisticated profile visitors know this, so the counter is primarily a visual element rather than a meaningful metric. It is most useful when your profile has substantial real traffic — a five-figure count communicates reach in a way that a two-figure count does not.

Adding the counter requires one line of markdown. Replace YOUR_USERNAME with your GitHub username:

![Profile Views](https://komarev.com/ghpvc/?username=YOUR_USERNAME)

For a styled badge with a custom label and color:

![Profile Views](https://komarev.com/ghpvc/?username=YOUR_USERNAME&label=Profile%20views&color=0e75b6&style=flat)

Common style values: flat, flat-square, plastic, for-the-badge. The for-the-badge style matches the shields.io tech stack badges used in most skill sections. Place the counter in your README header near your name and bio, or at the bottom as a footer element.

The counter supports several URL parameters for customization:

• color: Hex color without the # prefix (e.g., color=0e75b6 for blue)
• label: Custom text label (e.g., label=Visitors)
• style: Badge style — flat, flat-square, plastic, for-the-badge
• base: Starting count if you want to offset the displayed number
• abbreviated: Set to true to show abbreviated numbers (e.g., 1.2k instead of 1200)

To match the dark GitHub theme, use color=blueviolet or color=0079d3. For a minimal look that blends into markdown, use style=flat with no label (label=). The badge works identically in both GitHub's light and dark modes since it renders as a PNG rather than an SVG.

If the badge shows a broken image, verify that your username is spelled correctly in the URL — it is case-sensitive. If it shows zero views even after several visits, try clearing your browser cache and reloading. The counter is sometimes slow to initialize on the first request.

If you need to reset your counter or set a specific starting number, use the base parameter: ?username=YOUR_USERNAME&base=500 will start counting from 500. Note that the komarev.com service does not offer authentication or account management — the counter tied to your username is publicly readable and can be embedded by anyone. This is a known limitation of the pixel-counter approach.