Creating a custom badge for your GitHub App

You can replace the default badge on your GitHub App by uploading your own logo image and customizing the background.

By default, a new GitHub App will have an automatically generated identicon. An identicon badge looks something like this:


After you create a GitHub App, you can customize your app's badge by uploading a logo and selecting a background color. A badge is a square logo image inside of a circular badge. You can choose a background color for the badge, which can visually distinguish your app.

Your logo should be a PNG, JPG, or GIF file under 1 MB in size. For the best quality rendering, we recommend an image size of at least 200px x 200px. See "Tips for logo and badge images" for more guidance on customizing badges.

You can change a custom badge for a GitHub App that already has an approved Marketplace listing by navigating to

To create a custom badge:

  1. Klicke in der oberen rechten Ecke einer beliebigen Seite auf Dein Profilfoto und klicke dann auf Settings (Einstellungen). Symbol „Settings" (Einstellungen) auf der Benutzerleiste
  2. Klicke auf der linken Seitenleiste auf Developer settings (Entwicklereinstellungen). Abschnitt „Developer settings“ (Entwicklereinstellungen)
  3. In the left sidebar, click GitHub Apps. Abschnitt „GitHub Apps“
  4. To the right of the GitHub App you want to modify, click Edit. App selection
  5. In "Display information", drag-and-drop an image from a local folder or click Upload a logo to select an image from your computer. Upload a logo
  6. Schneiden Sie das Bild zu. When you're done, click Set new avatar. Crop and set logo
  7. In "Badge background color", type the hexadecimal color code of the background color for your badge. Note: The "Badge background color" input field will only appear after you upload an application logo. Badge background color

Nächste Schritte:

For more information about creating a Marketplace listing for this app, see "Listing on GitHub Marketplace".

Did this doc help you?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.