Jira for Slack

Jira provides robust workflows and project tracking. If your team uses Jira, integrate one of these apps to stay up to date without ever leaving Slack.

 

Decide which app to use

Jira Cloud

Jira Server Alerts (Legacy)

Use the Jira Cloud app to get Jira notifications in Slack when you’re using the cloud version of Jira.  

Here’s how it works:

  • Prompt Jira bot to send customisable notifications to you and your channels.
  • Once you’ve connected a project to a Slack channel, Jira bot will automatically preview Jira issues in Slack when they’re mentioned.
  • Use message actions to create new issues or add to existing issues in Slack.
  • Use slash commands to manage and look up issues in Slack.

Jira Server Alerts (Legacy) allows you to receive Jira notifications in Slack if you use a self-hosted version of Jira.

Here’s how it works:

  • Receive notifications in Slack when a Jira alert is created or updated.
  • Customise which issue statuses will trigger a notification.

Note: The Jira Server Alerts app is a legacy app, so new installations are not available. If Jira Server Alerts (Legacy) isn’t already installed to your workspace and you use a paid Jira server or data centre instance, you’ll want to use the Jira Server app instead.

Note: You’ll need to be an administrator in Jira to configure these apps.

 

The Jira Cloud app

To use the Jira Cloud app, your team should be using Jira Cloud. Keep reading to learn how to get set up.

Set up the Jira Cloud app

  1. Visit the Jira Cloud page in the Slack App Directory.
  2. Click on the Add to Slack button at the top of the page.
  3. Select the Slack workspace that you want Jira Cloud to authorise.
  4. Click Authorise.

Jira bot will send you a direct message to confirm that you’ve successfully connected the app. To get started, simply invite Jira bot to one of your channels or use the slash command /jira connect [your Jira URL].

 

Jira Server Alerts (Legacy)

Set up Jira Server Alerts (Legacy)

  1. From your desktop, click on  Apps at the top of the left sidebar. If you don’t see this option, click  More to find it.
  2. Search for and select Jira Server Alerts (Legacy).
  3. Click on Configuration.
  4.  Click on Add to Slack below the Jira icon on the left.
  5. Choose a channel where you want Jira notifications to be posted.
  6. Click on Add Jira integration.
  7. Copy the webhook URL on the page.
  8. In your Jira account, click on System in the Administration menu.
  9. Click on Webhooks in the sidebar under Advanced.
  10. Click on Create a webhook to see the webhook creation form, enter a name (e.g. Slack) and paste in the webhook URL from step 5.
  11. Under Events, choose what you want to receive notifications for.
  12. Click on Create when you’ve finished.

Limit updates to certain Jira projects

Using the Jira Query Language (JQL), you can limit your webhook to only post notifications from certain projects. For a single project, use project = ‘Project A’, and for multiple projects, use project in (‘Project A’,’Project B’).

Customise Jira status changes

Slack will automatically post some issue status changes (e.g. Open  Done and Closed   Reopened), but you can also customise the supported transitions to suit your team’s needs.

For example, you can add a status change when an issue transitions from In development  In review. Status names must match the statuses that are configured in your team’s Jira account.

Wildcard status changes

We also allow the use of wildcards in place of a single status. For example, if you want to receive notifications when any issue (regardless of its status) transitions to Done, you can add a status change that reads *  Done.

Event logs

When a Jira issue is created or updated, we temporarily log the event to help with debugging. You can check this log to see if a given status change was delivered or ignored. If you want to then support this status change, it’s easy to add to your list!