Versions Compared

Old Version 18

changes.mady.by.user Michelle Ruoff

Saved on

compared with

New Version Current

changes.mady.by.user Megan Storie

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

Install Integration+ with just a few steps. The setup is a one-time process that lets your team start immediately. 

To install, you must be a Jira admin. We understand that not everyone is a Jira admin. Contact your Jira admin and send them the information in this document to get them started

Organizations that have Slack Enterprise Grid have the option to deploy Enterprise-ready apps across their organization, instead of needing to install the app manually for each workspace. The steps below will work for org-wide or workspace-level installations. Just choose the Organization from the dropdown on the “Install Slack app” step.

To start the install, you will need to be a Jira admin. To install Org-wide, you will need an Enterprise Grid Org Admin. The process will give you an opportunity to select “I can't install Slack apps,” which will allow you to send a link to your Org Admin to install the Slack app if necessary.

On this page:

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printabletrue

  • Each Slack workspace can connect to only one Jira instance.

  • A single Jira instance can connect to multiple Slack workspaces or organizations.

  • The account that establishes the Jira connection will become the Main authorized user. This account’s Jira permissions determine the integration’s access across organizations and workspaces. We typically recommend using a Service Account. This account can be changed at any time from the Account Portal.

  • The user installer must have Slack permissions to add an integration to the workspace or organization.

Download the app from Atlassian Marketplace

  1. Go to Begin at https://marketplace.atlassian.com and enter Slack Integration+ in the search field.Select Try it for free and choose /apps/1219324/slack-integration-for-jira

  2. Choose your preferred Hosting Type (Cloud or Data Center) and select Try it for free.

  3. Choose your Jira instance from the drop-down menu and click Start Free Trial.

Image of the try it free button in Atlassian Market placeImage RemovedImage Added

Setup with both

Slack and Jira admin permissionsFollow

Jira and Slack admin permissions

If you are a Jira admin and can install Slack apps, you can follow these steps to get set up and connected.

InfoThe

  1. Follow the steps for downloading the app in http from https://marketplace.atlassian.com/apps/1219324/slack-integration-for-jira.

  2. Once you download the app, you will be redirected to the Atlassian Marketplacemanage applications once you download the app. Look for a notification in the bottom left corner indicating that Slack Integration+ has been installed.

  3. Click Get started.

  4. Click connect slack workspace.

  5. Click Copy & Go to Application Links .

Info

See the illustrated guide.

  1. Click Create Link.

  2. Paste the link you copied into the application URL field and click Continue.

  3. Ensure that the ‘I am an administrator on both instances’ remains checked, and click Continue.

  4. Click Allow to complete the process.

  5. Click Install Slack app.

  6. Click Allow.

  7. Click Finish setup in Slack.

  8. Navigate to the Jira Integration Plus app in the Slack sidebar.

  9. Click Connect Now in the home tab.

  10. Click Allow.

Image RemovedImage RemovedImage RemovedImage RemovedImage Removed

Setup with only Jira admin permissions

  1. Start the process by following steps 1-9 in the Setup with Both Jira and Slack permissions section.

  2. After this initial setup, you will receive two options if you are not a Slack admin:

    • Option 1: Request approval

      • Click Install Slack app>Select target workspace>request.

    • Option 2: Send the installation link to your Slack admin

Info

Use the Message template provided.

Image Removed

    1. If you do not see this notification, expand the Slack Integration+ for Jira app in your app list.

  2. Click Get started.

  3. Click Connect Slack workspace.

  4. Click Copy & Go to Application Links.

Info

See a recording of this process.

The application link creation experience looks slightly different for Cloud and Data Center.

Cloud

  1. Click Create link, leave the Direct application link option selected, paste the application URL (typically https://account.nextup.ai), then click Continue.

  2. Review the link, leave the ‘I am an administrator’ box checked, and click Continue to proceed.

Data Center

  1. Click Create link, leave the selection on Atlassian Product, paste the application URL (typically https://account.nextup.ai) and click Continue.

If you are on an older version of Jira Data Center, you must paste the application URL before clicking Create new link.

  1. You will be redirected back to Jira. Click Allow to grant permission for the integration.

Next, select

  1. Click Install Slack app.

  2. Ensure you have selected the correct Slack

account or workspace and click Accept and Continue. 

  • Complete the Slack authentication steps as prompted. 

  • Finally, choose the Jira Integration+ application by clicking Add to Slack. 

    • Depending on your permissions, you will either send a request to your Slack admin or directly approve it yourself.

    1. Grant Jira Integration+ permission to access your Slack workspace by selecting Allow. 

    Cloud:

    image-20240516-154644.pngImage Removed

    Data Center:

    image-20240516-154901.pngImage Removedimage-20240516-183318.pngImage Removed

    1. workspace or organization in the upper right.

    2. Click Allow.

    3. Click Finish setup in Slack.

    4. Navigate to the Jira Integration Plus app in the Slack sidebar.

    5. Click Connect Now on the home tab.

    6. Click Allow.

    Image AddedImage Added

    Cloud:

    image-20240516-154644.pngImage Added

    Data Center:

    createlink.pngImage Addedcreate new link.pngImage Addedadmin on both.pngImage AddedJira i plu.pngImage Added

    Setup with only Jira admin permissions

    If you are a Jira administrator but do not have permission to install Slack apps, follow these steps.

    1. Start the process by following steps 1-9 in the Setup with Both Jira and Slack permissions section.

    2. After this initial setup, you will receive two options if you are not a Slack admin:

      • Option 1: Request approval

        • Click Install Slack app → Select the target workspace → Click Request.

      • Option 2: Send the installation link to your Slack admin

        • Click the copy button next to the installation link and send it to your admin, or use the message template for more context.

    Info

    Use the Message template provided.

    e0294da3-d189-49cc-9ee2-942134db7ede.pngImage Added