How to Add GitHub Trophies to Your Profile README

GitHub Profile Trophy is a service that awards visual trophies based on quantitative GitHub activity thresholds. Each trophy category has six levels: Secret (hidden until threshold met), Bronze, Silver, Gold, Platinum, and SSS. The levels correspond to increasingly difficult GitHub metrics — for example, the 'Commits' trophy reaches Gold at 500 commits and SSS at 5,000.

The trophy row is a gamification layer that makes your contribution history more visually engaging. It works best for developers with meaningful GitHub activity — if your account is new or lightly used, some trophies will show at Secret rank, which may look sparse. The rank filter parameter lets you show only trophies you have actually earned above a certain level.

Adding trophies requires one line of markdown:

![Trophies](https://github-profile-trophy.vercel.app/?username=YOUR_USERNAME&theme=tokyonight&no-frame=true&row=1)

To show only your highest-ranked trophies:

![Trophies](https://github-profile-trophy.vercel.app/?username=YOUR_USERNAME&rank=S,SS,SSS,A,AA,AAA&theme=tokyonight&no-frame=true&row=1)

For a centered display with 6 trophies per row:

<div align="center">
  <img src="https://github-profile-trophy.vercel.app/?username=YOUR_USERNAME&theme=tokyonight&no-frame=true&row=1&column=6" />
</div>

Replace YOUR_USERNAME with your GitHub username. The service fetches your data from GitHub's API in real time — no authentication, no Action, no setup.

Key customization parameters:

• theme: Available themes include tokyonight, darkhub, onedark, gruvbox, radical, flat, algolia, gitdimmed, transparent, nord, juicyfresh
• rank: Filter by rank level — SECRET, SSS, SS, S, AAA, AA, A, B, C (comma-separated to show multiple)
• no-frame=true: Removes the border around each trophy
• no-bg=true: Removes the background (use with transparent theme for borderless cards)
• row: Number of rows (default 1, max 3)
• column: Number of columns per row (default 6, max 6)
• margin-w and margin-h: Pixel margin between trophies

Hiding specific trophies: add &hidden=reviews,experience where experience corresponds to the 'Experience' trophy category.

If the trophy card shows a 'No data available' error, check that your GitHub username is spelled correctly and your profile is public. The service reads your public GitHub data — private repository contributions are not included in trophy calculations.

If the card renders but all trophies show as 'Secret', it means you haven't met the minimum threshold for any visible trophy rank. This is common for newer accounts. Use &rank=SECRET to confirm the widget is working correctly, then build up activity to reveal trophies.

If the image is not rendering in your README, confirm you are using the correct base URL: github-profile-trophy.vercel.app (not github-profile-trophies). The vercel.app domain is rate-limited on the free tier — if loading frequently fails, deploy your own instance.