The Jira Cloud for Slack app allows you to connect Jira projects to Slack, see personal notifications, view automatic issue previews, create Jira issues, and interact with Jira issues - all from within Slack.

Integrate Jira Cloud and Slack

  1. Install the Jira Cloud for Slack app onto your Slack workspace. 
  2. After installing, you'll be guided to log into your Atlassian account to link Slack and Jira; this should only take a minute.
  3. After logging in, you'll get a direct message from the Jira Cloud app in Slack. From here, you'll be able to connect your first Jira project to a Slack channel.

Once this is set up, the following will become available:

  • Personal Jira notifications in Slack - Get personal Jira notifications in Slack via a DM with @Jira instead of via email.
  • Connect Jira projects to Slack - Get updates for a specific project in Slack via a DM with @Jira or in a channel of your choosing.
  • Issue previews - Automatically send helpful issue previews whenever a Jira issue link/issue key is sent in a conversation
  • Create issues from Slack - Create issues straight from Slack, in the context of a conversation
  • Interact with issues from Slack - Transition, assign, comment on, and watch issues right from Slack.

Get personal Jira notifications in Slack instead of email

Once you've added the Jira Cloud app to your Slack workspace, you can start receiving your personal Jira notifications in Slack.

  1. In Slack, open a DM with @Jira, any public channel, or a private channel that @Jira has been invited to.
  2. Enter /jira notify.
  3. Select Turn on personal notifications.
  4. Choose when you want to be notified and select Submit.

Once you’ve set up personal notifications in Slack, you can disable email notifications by going to Jira in Personal settings > Email notifications for issue activity.

Connect a Slack channel to a Jira Project

Once you've added the Jira Cloud app to your Slack workspace, you can set up a Jira Cloud project to send notifications into a Slack channel a couple of different ways.

Invite the bot to a channel

Any time you invite the Jira Cloud bot into a Slack channel, the bot will give you the ability to quickly create a connection between that channel and a project:

If your Atlassian account is connected to multiple Jira Cloud sites, select the site and then the project that you want to connect to the channel. Once you’ve established this connection, you’ll get a confirmation sent to the channel.

Type /jira connect

In public and private channels, you can type /jira connect to quickly set up a connection between Jira Cloud and Slack.

Note: This functionality is not supported in direct messages with other Slack users.

Manage a connection between a Jira Cloud project and a Slack channel

You can manage your subscription settings by typing /jira manage in the channel you want to update. From there, select Manage to configure the connection in Jira Cloud. 

Use the Jira Cloud for Slack app to provide a preview of Jira issues

When someone writes a message with one or more Jira issue links or issue keys (in upper case, so DEV-36 not dev-36), the bot will unfurl the message and show a preview of the issues. That way, readers of the message don’t have to go into Jira to understand what the sender is talking about:

Note: To unfurl a Jira issue with an issue key (e.g. DEV-36) in a Slack channel, the channel must be connected to the relevant project (e.g. DEV) via /jira connect

Interact with Jira issues from Slack (aka unfurling)

Whenever Jira issue previews are unfurled by the bot, you can take action on them by selecting the interaction button below the preview or the “More actions…” menu. That way, you don’t have to leave the context of the conversation to update an issue in Jira.

Access Jira issues without leaving Slack

To see your work from Jira without leaving Slack:

  1. Find the “Apps” section in the sidebar with your channels and DM’s.
  2. Navigate to the “Jira” app and go to the “Home” tab.
  3. Here you will find your work from Jira: issues that are assigned to you and issues that you are watching.

You can unwatch/watch, assign, transition, or comment on any of these issues by selecting the  menu beside the issue.

Use slash commands in the Jira Cloud Slack app

There are a few slash commands you can use while interacting with Jira Cloud for Slack:

Slash command

Action

/jira notify

Get your personal Jira notifications directly in Slack. If you’ve already set up personal notifications, you can use /jira notify to adjust your notification preferences.

/jira connect

Connect a Slack channel to a Jira project and receive updates on the latest notifications of that project.

/jira manage

Manage the Jira project connections for that specific channel

/jira create

Quickly create Jira tickets from Slack by filling out the summary, description, and issue type with the dialog that is created from this command. If you have a project connected to the Slack channel you issue this command from, the project will be automatically selected as the project for the created issue.

Note: The fields that appear in Slack are not guaranteed to be in the same order that they appear in Jira.

/jira create [issueType] [Summary] [description]

An even quicker way to create Jira issues. You can specify issue type, summary, and description by using this syntax. For example:

/jira create bug Printer is on fire

The printer on floor 16 is on fire. I suspect this has a high priority

/jira [issue key]

Get information about a specific Jira Cloud issue. For example:

/jira PROJ-12

Note that this information will only be visible the person who uses the command.

/jira feedback

Give feedback about the Jira Cloud for Slack app.

/jira logout

Log out of your Atlassian ID. Your Atlassian ID is used to retrieve the list of sites to connect to or create Jira issues from. Logging out will not remove or suspend any of your previously set up subscriptions.

/jira help

Show help information about different slash commands that are available to you.

Migrating from the Jira Server Integration for Slack to the Jira Cloud app

If you've already set up the Jira Server integration based on webhooks for your Jira Cloud site, follow these steps to switch to the Jira Cloud app:

  1. Go to your-slack-team.slack.com/apps/manage and choose Jira Server.
  2. For each configuration you want to remove, select the pencil icon and then choose Disable or Remove in the top-right corner.
  3. Go to https://slack.atlassian.com and select Add to Slack to install the new Jira Cloud for Slack app.
  4. Follow the installation instructions to set up the new app.

Once you've confirmed your Jira Cloud site, you can configure the new app to manage your previous settings.

Security considerations

The Jira Cloud for Slack app respects existing Jira permissions at the issue level and at the administration level.

  • If @jira is connected to a Jira Cloud project with issue-level security, you won't receive Slack notifications for issues with security settings.

If the app is not enabled, you may see a message such as: "Connecting with this Jira Cloud instance was disabled by administrator".