About badges
Every GitHub App has a badge. A badge is a square image inside a circular background.
By default, a new GitHub App will use an automatically generated identicon as a badge. An identicon badge looks something like this:
After you register a GitHub App, you can customize your app's badge by uploading a logo and selecting a background color. Your logo should be a PNG, JPG, or GIF file under 1 MB in size. For the best quality rendering, we recommend an image dimension of 200 pixels by 200 pixels.
Creating a custom badge
- In the upper-right corner of any page on GitHub, click your profile photo.
- Navigate to your account settings.
- For an app owned by a personal account, click Settings.
- For an app owned by an organization:
- Click Your organizations.
- To the right of the organization, click Settings.
- In the left sidebar, click Developer settings.
- In the left sidebar, click GitHub Apps.
- To the right of the GitHub App you want to modify, click Edit.
- Under "Display information", drag and drop an image from a local folder or click Upload a logo to select an image from your computer.
- Optionally, crop your image.
- Click Set new avatar.
- Under "Badge background color", type the hexadecimal color code of the background color for your badge.