GitHub brings teams of software developers together to write code and manage projects. When you connect GitHub to Slack, you can get notified of all sorts of events in the Slack channel(s) of your choosing. Connect two of your most important tools and stay on top of your work, all from Slack. 🛠
Decide which app to use
GitHub for Slack: Are you on the GitHub Developer, Team, or Business plan? This app is for you!
Github Notifications (Legacy): This app is compatible with GitHub Enterprise.
Install the app
GitHub for Slack
GitHub Notifications (Legacy)
With the GitHub app, you can get link previews in Slack for public repositories, set up notifications with slash commands, and easily stay up-to-date on project activity.
Review the permissions the app needs to access, and click Continue to allow.
Select the channels the app can access: all public channels, specific ones, or none.
After you've installed the app, the GitHub app will send you a direct message to help you complete setup and teach you about the /github slash command.
Tip: Use the slash command /github subscribe owner/repo to subscribe to your previous configurations.
Customize your notifications
The GitHub app makes it easy to customize what gets posted in Slack. You can subscribe to activity that's relevant for the whole channel to see, and unsubscribe from other types that are less helpful. Certain activities will notify you in Slack by default, while some others won't:
Features enabled by default
issues
pulls
statuses
commits
deployments
public
Features not enabled by default
reviews
comments
branches
commits:all
You can use these slash commands to customize your notifications:
/github subscribe owner/repo [feature]
/github unsubscribe owner/repo [feature]
A note about the GitHub app
If you use other Slack apps, you might notice some changes in the way GitHub is installed. This particular app functions at your workspace level, rather than at the member level. This is a good thing! Here's why:
The app will never disconnect should the original installer ever leave your workspace.
You can add the GitHub app to specific channels. Take your pick during installation, or use /invite @github to add the app to any channellater on.