Installation and setup for Integration+

Owned by Megan Storie
Last updated: Dec 05, 2024 by Megan Storie
4 min read

Overview

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

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.

  • 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 installer must have Slack permissions to add an integration to the workspace or organization.

 

 

 

Download the app from Atlassian Marketplace

  1. Begin at Slack Integration+ for Jira | Atlassian Marketplace

  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.

 

 

 

Setup with both 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.

  1. Follow the steps for downloading the app from Slack Integration+ for Jira | Atlassian Marketplace.

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

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

  3. Click Get started.

  4. Click Connect Slack workspace.

  5. Click Copy & Go to Application Links.

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.

  1. Click Install Slack app.

  2. Ensure you have selected the correct Slack workspace or organization in the upper right.

  3. Click Allow.

  4. Click Finish setup in Slack.

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

  6. Click Connect Now on the home tab.

  7. Click Allow.

 

Cloud:

 

Data Center:

 

 

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.