JIRA integration

The Roadmap & JIRA two-way integration pushes ideas created in Roadmap to tickets in your JIRA projects.

With the JIRA integration for roadmaps, product teams increase transparency without over-complicating the experience for non-technical stakeholders. The Roadmap integration for JIRA keeps stakeholders in the loop with notifications when there’s progress from JIRA.

Why It Matters

JIRA is a massive (and helpful!) product for development teams to get things done. However, it’s not a tool designed to communicate with non-technical teammates or users.

The Roadmap & JIRA integration works across the organization to collect feedback, track ideas, and align stakeholders around progress from JIRA.

How It Works

Once you enable the integration, you’ll be able to push ideas from your backlog or stories to create high-level tickets in JIRA. Customize in integration settings whether you’d like to push ideas:

  1. as soon as an idea is created or
  2. when an idea is added to a story or
  3. manually

The manual option is best if you’re using multiple project management tools such as JIRA and Trello together. If you’re using the manual option, each idea will have the option to be pushed to JIRA once it is added to a story.

Push to JIRA

When tickets are completed in JIRA, progress is automatically tracked in Roadmap. You can turn on and customize notifications to be sent automatically to your team and/or your app users.

Track progress

Get Started

Step 1: Creating an Application Link in JIRA

From the Jira Dashboard on the left, click on Jira Settings -> Products -> Application Links

The application link is https://roadmap.space

If at first you see a not responding error, simply click continue.

  • Application Name: Roadmap
  • Application Type: Generic Application
  • Check the checkbox for “Create Incoming Link”.

Click the Continue button.

  • Consumer Key: dpf43f3p2l4k3l03
  • Consumer Name: Roadmap 

On the JIRA integration page in Roadmap, you’ll find your public key. Copy and paste your public key into the “Public Key” field in JIRA. Be sure to include the entire key, including the BEGIN & END parts.

Note: If there is a firewall between your JIRA server and the internet, you’ll need your system admininistrator to allow traffic from our IP addresses. Reach out to us at support@roadmap.space or via the in-app messenger for the IP addresses.

Note: If you are self-hosting with a non-https endpoint the integration will not work. It is strongly recommended to use https.

Step 2: Creating a JIRA integration on Roadmap

Enter your JIRA base URL for your corresponding installation type. To install the JIRA integration for product roadmaps, go to Settings –-> Integrations –-> Connect.

Connect to JIRA

(a) Cloud (JIRA OnDemand): in this case JIRA is hosting your app for you and you have a URL similar to https://company.atlassian.net. (b) Self-hosted: in this case you’re hosting your JIRA installation and your URL is similar to https://company.com/jira.

  • It’s important to use https and keep the trailing slash during installation. *

Step 3: OAuth with JIRA

Once you’ve set up the Application Link, return to Roadmap to continue setting up the integration. You’ll be asked to authorize the connection between Roadmap and JIRA.

JIRA OAuth

Step 4: Map to a JIRA project

In this step you’ll see a list of your JIRA projects and issue types. If you’re using more than 1 roadmap you can create separate JIRA integrations with multiple projects.

Select the JIRA project where ideas should be created and select the issue type you’d like to create. Select an issue type that has a summary and description field and there aren’t other required custom fields.*If you have additional custom fields you’d like to map from ideas, let us know and we’ll help you get them set up.

Step 5: Create a webhook to track closed tickets (optional)

Create a webhook with JIRA to track ideas as completed in Roadmap when the ticket is closed in JIRA. Use the URL provided on the integrations page in Roadmap. Learn more about how to create a webhook in JIRA’s documentation here.

  1. The webhook URL is available from the JIRA integration page in Roadmap
  2. Select Issue Type = Updated as the only event type Roadmap needs to receive to mark ideas as complete

Feedback ❤️

Love to use Roadmap & JIRA together? Have some ideas to make this integration even better? We’d love to hear from you!