Skip to content
GigAI Tools
4 tools

Resize an Image for GitHub

Profile avatar and repo social preview: the right GitHub sizes so your profile and shared links look professional.

The quick answer

GitHub uses a 460×460px avatar (displayed smaller, so keep it simple) and a 1280×640px social preview image for repositories: the picture shown when a repo link is shared. Crop to a square for the avatar and 2:1 for the social preview, then resize. Our tools do it in your browser.

GitHub image requirements
Profile avatar460 × 460 px (square, displays small)
Repo social preview1280 × 640 px (2:1, min 640×320)
FormatPNG or JPG, under 1 MB (social preview)

How to do it

  1. 1

    Pick what you're setting

    A profile avatar (square) or a repository social preview (2:1).

  2. 2

    Crop to the ratio

    1:1 for the avatar, 2:1 for the social preview, with Crop Image.

  3. 3

    Resize to the pixels

    460×460 for the avatar, 1280×640 for the social preview, in Image Resizer.

  4. 4

    Compress and upload

    Keep the social preview under ~1MB with Image Compressor.

GitHub tips
  • The social preview (1280×640) is what shows when someone shares your repo on social or chat. Make it clear and branded.
  • Avatars display small. A simple mark or clear photo reads best.
  • Set a social preview on important repos so links don't share as a blank card.

Frequently asked questions

Start with Image Resizer

Free, private and instant: everything runs in your browser.