Configure the Slack integration

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 that 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

You can use slash commands while interacting with Jira Cloud for Slack. View the full list of slash commands.

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 the Atlassian and Slack integration page 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.

• To connect with the Jira Cloud app, your site administrator needs to enable it at https://<instancename>.atlassian.net/plugins/servlet/ac/jira-slack-integration/addon-config-page. If the app is not enabled, you may see a message such as: "Connecting with this Jira Cloud instance was disabled by administrator".