ProfileCrest Developer Blog — Tutorials & Guides
ANALYTICS & METRICS August 5, 2026 7 min read CodeCrest Engineering Team

How to Add a Custom Visitor Counter Badge to GitHub README

Track unique profile visits on GitHub using custom SVG visitor counter badges. Learn how counting services work, how to style your badges, and how to avoid counter inflation.

Why Use a Visitor Counter Badge?

Unlike traditional websites that use Google Analytics or client-side JavaScript tags, GitHub profile READMEs cannot execute custom scripts. Instead, profile analytics rely on SVG badge images hosted by counting services.

A visitor counter badge provides social proof, showing recruiters and peers that your profile is receiving attention and engagement.

How GitHub Visitor Counters Work

When someone opens your GitHub profile, GitHub's image proxy (Camo) requests the SVG image from the counter service API. The service tracks unique IP addresses, increments the total view count, and dynamically generates an SVG badge showing the updated number.

Syntax for GitHub Profile Visitor Badge

The standard syntax using Komarev's popular counter API:

![Profile Views](https://komarev.com/ghpvc/?username=YOUR_GITHUB_USERNAME&color=cc785c&style=for-the-badge)

Customization Parameters

  • color — Sets the right side badge color (hex code without #).
  • label — Customize text label (e.g. label=PROFILE%20VIEWS).
  • style — Choose badge style (for-the-badge, flat, flat-square).
  • base — Set initial baseline offset count if migrating from another counter.

Add Visitor Badges with ProfileCrest

ProfileCrest pre- configures visitor badges with matching color themes and styles.

🚀 Open ProfileCrest Generator
Previous: Contribution SnakeNext: Readme Stats Customization