The GitHub integration for Slack gives you and your teams full visibility into your GitHub projects right in Slack channels, where you can generate ideas, triage issues and collaborate with other teams to move projects forward. This integration is an open source project, built and maintained by GitHub.

• Installing the GitHub integration for Slack
  • Requirements
  • Installation
  • Authorization
• Getting Started
  • Migrating from the legacy GitHub integration for Slack
  • Repository Activity
  • Public Link Unfurls
  • Configuration
• Need help?
• Contributing
• License

This app officially supports GitHub.com and Slack.com but the team plans to support GitHub Enterprise and Slack Enterprise Grid in the future.

When you install the new GitHub integration for Slack in your Slack workspace, you'll be prompted to reconfigure your old settings - so getting set up again is easy. Once you subscribe with the new app, the legacy app will be disabled but the legacy notification configurations will be migrated automatically.

Install the GitHub integration for Slack. After you've signed in to your Slack workspace, you will be prompted to give the app access:

After the app is installed, you will see public links to GitHub issues, pull requests, and code rendered as rich text via a Slack unfurl in your workspace.

At this point, your Slack and GitHub user accounts are not linked. To link the two accounts, authenticate to GitHub using a /github slash command, /github signin.

The /github slash command also accepts a subscribe argument that you can use to subscribe to an Organization or Repository's activity /github subscribe <organization>/<repository>.

If you originally gave the app access to "All repositories" and you've created a new private repository on GitHub after installing the GitHub integration for Slack, the /github subscribe command will work automatically on your new repository. If you installed the app on a subset of repositories, the app will prompt you to install it on the new repository.

The /github slash command also supports unsubscribe. To unsubscribe to notifications from a repository, use /github unsubscribe <organization>/<repository>

By granting the app access, you are providing the following authorizations to your GitHub and Slack accounts:

Subscribe to an Organization or a Repository On repositories, the app notifies of open, close, and re-open events on pull requests and issues in repositories you've subscribed to. It also notifies of any push directly to the repository's default branch as well as comments on issues and pull requests.

When a user posts a GitHub link in Slack for a public repository, the app is designed to unfurl issues and pull requests, directly linked comments, code blobs with line numbers, as well as organizations, repositories, and users.

You can customize your notifications by subscribing to activity that is relevant to your Slack channel, and unsubscribing from activity that is less helpful to your project.

Settings are configured with the /github slash command:

/github subscribe owner/repo [feature]
/github unsubscribe owner/repo [feature]

These are enabled by default, and can be disabled with the /github unsubscribe owner/repo [feature] command:

• issues - Opened or closed issues
• pulls - New or merged pull requests
• statuses - Statuses on pull requests
• commits - New commits on the default branch (usually master)
• deployments - Updated status on deployments
• public - A repository switching from private to public

These are disabled by default, and can be enabled with the /github subscribe owner/repo [feature] command:

• reviews - Pull request reviews
• comments - New comments on issues and pull requests
• branches - Created or deleted branches
• commits:all - All commits pushed to any branch

You can subscribe or unsubscribe from multiple settings at once. For example, to turn on activity for pull request reviews and comments:

/github subscribe owner/repo reviews comments

And to turn it back off:

/github unsubscribe owner/repo reviews comments

Please fill out GitHub's Support form and your request will be routed to the right team at GitHub.

Want to help improve the integration between GitHub and Slack? Check out the contributing docs to get involved.

The project is available as open source under the terms of the MIT License.

When using the GitHub logos, be sure to follow the GitHub logo guidelines.