Deleting a GitHub App

You can delete GitHub Apps that you own if you no longer want to use or maintain the app.

In this article

Note

If you want to remove a GitHub App that you use but do not own, see Reviewing and modifying installed GitHub Apps instead.

About deleting GitHub Apps

If you own a GitHub App or are an app manager for a GitHub App, you can delete the GitHub App registration. For more information about GitHub App managers, see About GitHub App managers.

When you delete a GitHub App registration, the app will be uninstalled from all accounts that the app is installed on.

Note

If your GitHub App is published on GitHub Marketplace, you must remove your app from GitHub Marketplace before you can delete your app. For more information, see Deleting your app listing from GitHub Marketplace.

Deleting a GitHub App

  1. In the upper-right corner of any page on GitHub, click your profile photo.

  2. Navigate to your account settings.

    • For an app owned by a personal account, click Settings.
    • For an app owned by an organization:
      1. Click Your organizations.
      2. To the right of the organization, click Settings.

  3. In the left sidebar, click Developer settings.

  4. In the left sidebar, click GitHub Apps.

  5. Select the GitHub App you want to delete.

  6. In the left sidebar, click Advanced.

  7. Click Delete GitHub App.

  8. In the confirmation box, type the name of the GitHub App to confirm you want to delete it.

  9. Click I understand the consequences, delete this GitHub App.

These steps only delete your GitHub App registration, and all of the organization and account installations it may have. They do not delete any code that you wrote for your app. However, any code that relies on your GitHub App's credentials will no longer function.