GitHub Image Sizes & Presets
GitHub uses profile pictures across the platform at sizes from 40px in commit lists to 500px on profile pages. Social preview images appear when repositories are shared on social media and messaging apps, displaying at 1280x640 pixels. FastEdit helps you prepare both with one-click presets that handle sizing and format automatically.
Pick this preset, drop your file, and FastEdit starts from the GitHub Profile Picture dimensions, format, and file-size target.
GitHub Image Size Cheat Sheet
Profile Picture
500x500 PNG / JPEG Max 1 MB
GitHub avatar displayed across the platform. Shown as small as 40px in commit lists and up to 500px on profile pages. Use a square image with the subject centered.
Open GitHub Profile Picture preset →Social Preview
1280x640 PNG / JPEG Max 1 MB
Repository social preview image. Displayed when a repo URL is shared on Twitter, Slack, Discord, and other platforms. Set via Settings > Social Preview in your repository.
Open GitHub Social Preview preset →Before you upload
- GitHub avatars are displayed as circles: keep the subject centered and avoid important content in the corners.
- Social preview images should have a 2:1 aspect ratio (1280x640). Images with other ratios will be cropped.
- Use PNG for avatars with transparency or sharp edges. Use JPEG for photographic social previews to keep file sizes small.
- If no social preview is set, GitHub auto-generates one from the repo name and description. A custom image stands out much better in shared links.