Connecting Jira with Insights allows you to track engineering productivity, including cycle times, issue progress, and delivery metrics, all in one place. This guide walks you through the full setup process.
1. Navigate to Settings
To begin, click the Settings icon in the bottom left of your sidebar.
2. Add Team Members
Inside the Settings page, navigate to the Members tab.
-
Click Add a new member to add the engineers whose cycle times and issue data you want to track.
-
Once members are added, you’ll be able to link them with their Jira accounts later in the process.
3. Open Jira Integration
Next, go to the Integrations tab and select Jira Integration.
4. Enter Jira Connection Details
Fill in the required fields for the Jira integration:
-
Domain Name – Use the domain of your Jira Cloud or Jira Server instance (e.g., https://yourcompany.atlassian.net/).
-
Service Account – (Recommended) Create a dedicated service account in Jira with access to the projects you want Insights to analyze.
- Alternatively, you may use a personal access token linked to your Jira user account.
-
API Token – Generate and paste the API token associated with your service account or personal account.
💡 Tip: Using a service account is recommended for reliability and centralized control.
5. Configure Import & Webhooks
Enable the following options for a complete setup:
-
Select to Import users from Jira → Ensures your Jira users are synced into Insights.
-
Select to automatically integrate with Jira webhooks → Allows Insights to update metrics automatically as activity occurs in Jira.
Alternatively, you can copy and paste the webhook link manually into Jira if you prefer.
6. Save Your Integration
Once all details are entered, click Save.
-
The initial connection may take a few minutes while Jira validates the service account or access token.
-
Once complete, Insights will begin importing data from your Jira projects.
7. Link Users to Jira
After setup, return to the Members tab to ensure users are correctly mapped to their Jira accounts.
-
Click the Jira icon beside each user.
-
Link the Insights member profile with the correct Jira user account.
This ensures that productivity and delivery metrics are accurately attributed to each engineer.
✅ Jira Integration Complete
Your Insights dashboard is now connected to Jira. You’ll start seeing data populate in areas like PR Cycle Time, Story Points, and Time in Status, giving you visibility into your team’s delivery flow.