This version of GitHub Enterprise will be discontinued on 2021-02-11. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Creating a custom badge for your OAuth App

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

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

Identicon

After you create an OAuth App, you can customize the 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 be used to 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.

To create a custom badge:

  1. In the upper-right corner of any page, click your profile photo, then click Settings.
    Settings icon in the user bar
  2. In the left sidebar, click Developer settings.
    Developer settings section
  3. In the left sidebar, click OAuth Apps.
    OAuth Apps section
  4. Select the OAuth App you want to modify.
    App selection
  5. In "Application logo", drag-and-drop an image from a local folder or click Upload new logo to select an image from your computer.
    Upload a logo
  6. Crop your picture. When you're done, click Set new application logo.
    Crop and set logo
  7. In "Badge background color", type the hexadecimal color code of the background color for your badge.
    Badge background color
  8. Click Update application.
    Button to update the application

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

Or, learn how to contribute.