GitHub specs
GitHub profile photo size: square avatar built for the circle
Photo size & upload specs
- Pixel dimensions
- 500×500 or larger
- Aspect ratio
- 1:1 (square)
- File size cap
- Under 1 MB preferred
- Ideal upload
- 1024×1024
- Formats
- JPG, PNG, or GIF
- Circle-crop safe area
- Center the face tightly. GitHub avatars render as circles next to every PR and issue — forehead and chin must sit inside the inscribed circle.
Avatars shrink to ~32–48 px in feeds; upload larger so compression still looks sharp.
GitHub wants a square avatar (500×500 or larger works well; 1024×1024 is a safe upload). Keep the file lean — under about 1 MB — in JPG, PNG, or GIF. The UI draws a circle next to every PR, issue, and commit.
Center the face tightly so forehead and chin stay inside the inscribed circle. HeadshotCam outputs a GitHub-ready square from one selfie — Lead Dev, Clean & Modern, or CTO — already framed for that crop.
Built for GitHub Profile Photo
500×500 or larger — sized for GitHub
Upload 1:1 (square), 1024×1024 ideal, under 1 mb preferred. JPG, PNG, or GIF — no awkward zoom, no clipped chin.
Circle-crop safe framing
Center the face tightly. GitHub avatars render as circles next to every PR and issue — forehead and chin must sit inside the inscribed circle.
Edit with words
Type "remove glasses", "navy blazer", or "lighter background" — the AI updates the detail while your face stays the same.
High-res, no watermark
Download print-quality files — no tiny logos, no "made with" stamps in the corner.
Best styles
Our picks for GitHub Profile Photo.
Tips
- 1 Tight, centred crop. GitHub uses round avatars — your face needs to fill the circle.
- 2 Solid colour top, no patterns. Patterns turn into noise at 32×32.
- 3 Match the photo on LinkedIn. Recruiters and contributors cross-check.
- 4 Refresh when you change companies. Otherwise leave it alone.
FAQs
What size should my GitHub photo be?
GitHub expects 500×500 or larger at 1:1 (square), under 1 mb preferred, in JPG, PNG, or GIF. Practical upload: 1024×1024. Avatars shrink to ~32–48 px in feeds; upload larger so compression still looks sharp.
How do I keep my face inside the GitHub circle crop?
Center the face tightly. GitHub avatars render as circles next to every PR and issue — forehead and chin must sit inside the inscribed circle.
Will it pass on GitHub?
Yes. The output is a realistic likeness of you, not a cartoon or filter. Pick a Foundations or Corporate style and the photo reads as a normal studio shoot.
Can I keep my face exactly the same?
Yes — your face, hair, and skin tone stay locked. Only clothing, lighting, and background change.
How fast is generation?
Most headshots are ready in 5 to 15 seconds. You can iterate, then "Edit with words" for tweaks, all in under a minute.
Related
Create your headshot
Skip the studio. Pro headshots in seconds, from one selfie. Free to download on iOS and Android.
Free to download on iOS & Android
- Free download
- 1 selfie
- 5–15 seconds
- No watermark
Scan to download
Point your phone camera at a code
