content/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app.md

metadata

title: Creating a custom badge for your GitHub App
intro: '{% data reusables.shortdesc.creating_custom_badges_github_apps %}'
redirect_from:
  - /apps/building-github-apps/creating-custom-badges-for-github-apps
  - /developers/apps/creating-a-custom-badge-for-your-github-app
  - >-
    /developers/apps/building-github-apps/creating-a-custom-badge-for-your-github-app
  - >-
    /apps/creating-github-apps/creating-github-apps/creating-a-custom-badge-for-your-github-app
  - >-
    /apps/creating-github-apps/setting-up-a-github-app/creating-a-custom-badge-for-your-github-app
versions:
  fpt: '*'
  ghes: '*'
  ghec: '*'
topics:
  - GitHub Apps
shortTitle: Custom badge

About badges

Every {% data variables.product.prodname_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.

{% ifversion fpt or ghec %}

For more information about badges for {% data variables.product.prodname_github_apps %} in {% data variables.product.prodname_marketplace %}, see AUTOTITLE. You can change a custom badge for a GitHub App that already has an approved Marketplace listing by navigating to https://github.com/marketplace/manage.

{% endif %}

Creating a custom badge

{% data reusables.apps.settings-step %} {% data reusables.apps.enterprise-apps-steps %} {% data reusables.user-settings.modify_github_app %}

1. Under "Display information", drag and drop an image from a local folder or click Upload a logo to select an image from your computer.
2. Optionally, crop your image.
3. Click Set new avatar.
4. Under "Badge background color", type the hexadecimal color code of the background color for your badge.

{% ifversion fpt or ghec %}

The "Badge background color" input field will only appear after you upload a logo.

{% endif %}

{% ifversion fpt or ghec %}

Next steps

For more information about listing your {% data variables.product.prodname_github_app %} in {% data variables.product.prodname_marketplace %}, see AUTOTITLE.

{% endif %}