For teams using Jira, Range has an integration which automatically imports issues and sub-tasks. Once you set up this integration, you'll be able to add a line to your update about issues and sub-tasks with a single click.
You'll see suggestions for Jira issues and sub-tasks in Range when:
- You create an issue and assign it to someone.
- You reassign an issue to someone else or an issue is assigned to you.
- You update an issue's status or an issue that's assigned to you has its status updated.
- You resolve an issue or an issue that's assigned to you is resolved
It's important to note that Range doesn't backfill issues; but rather sends issues to Range once they are assigned to you. You will need to reassign old issues to yourself.
There are two parts to setting up the Jira integration:
- First, an admin for your organization needs to set up the Jira integration for your organization. See instructions for admin here.
- Second, each teammate who wants to receive Jira suggestions in Range will need to follow the "Link your Jira identity to Range" instructions below.
If you have any feedback for how the Jira integration could work better for you and your team, please let us know! Just click the chat icon in the bottom right.
Linking your Jira identity to Range
Once a Range admin has set up the Jira integration for your organization, Range will import activity for each teammate based on their email address.
1. Log into your Range account and select Settings at the bottom left.
2. Under Link your identity, find the Jira section, and select Link.
3. Add your Jira User Account ID to Range.
Find your Jira User Account ID, and add it to Range
- Sign into your Jira Account
- Navigate to your profile (Found in the lower left corner)
- Copy your User Account ID from the browser's URL bar. It should look something like this (7fa70fb5a0b60324cf39f2f3) or this (543210:25a1872b-3dea-2ad1-001f-a3b81762acbe)
- Open Range Integration Settings
- Find Jira, click to Link, and paste your Jira User Account ID into the field
Once you do this, you should start seeing future Jira activity in Range. If you'd like any help, please let us know. You can reach out via intercom (bottom right button) or email us at email@example.com.
Can't find your User Account ID?
If your organization hosts your own instance of Jira, you may be on an older version of Jira that does not yet have Account IDs. In this case, you can use your email address.
Visual step-by-step guide
In Jira, open your profile:
Copy your Jira User Account ID from the Browser's URL bar:
Open Range Integration Settings and paste in your Jira User Account ID
Now you're all set! Still don't see your Jira activity in Range? Please let us know and we'll help out. firstname.lastname@example.org.
Jira is a webhook only integration and requires a Jira administrator configure events to be sent to Range servers. We recommend sending all issue related events, however, Jira can be configured using JQL to filter events, such that certain projects are excluded.
By default, users are matched to events via their email address. However, if different email addresses are used, users have the ability to specify an alternate email address.
Range persists the following data from Jira events:
- Issue Key
- Issue Summary
- Issue Description
- Issue URL
- Project Name
- Project Description
- Project URL
- Created At
- Modified At
- Closed At