Documentation/Jira Integration

IdeaLift for Jira

Turn Jira issues into tracked product ideas

Overview

IdeaLift for Jira connects your issue tracker to your product roadmap. Send any Jira issue to IdeaLift with one click, and status changes sync automatically in both directions.

1-Click
Capture from any issue
2-Way
Bidirectional sync
0 Config
Works out of the box

Installation

1Install from Atlassian Marketplace

Search for "IdeaLift" in the Atlassian Marketplace or use the direct installation link.

Install from Marketplace

2Grant Permissions

During installation, you'll be asked to grant the following permissions:

  • Read Jira work - Read issue details to capture as ideas
  • Write Jira work - Update issue status when idea status changes
  • App storage - Store links between issues and ideas

3Connect Your IdeaLift Workspace

In your IdeaLift dashboard, connect your Jira site:

  1. Go to Dashboard → Connections
  2. Click "Connect Jira"
  3. Select your Atlassian site
  4. Authorize the connection

How to Use

Sending an Issue to IdeaLift

  1. 1

    Open any Jira issue

    Navigate to the issue you want to track as a product idea

  2. 2

    Click the "..." menu

    In the top-right corner of the issue view

  3. 3

    Select "Send to IdeaLift"

    A panel will open showing a preview of the issue

  4. 4

    Add optional details

    Select a category and add notes if needed

  5. 5

    Click "Send to IdeaLift"

    The idea is created and linked to the issue

Viewing Linked Ideas

After sending an issue to IdeaLift, opening the IdeaLift panel will show:

  • • The linked idea ID (e.g., ILI-ABC-42)
  • • Current status in IdeaLift
  • • Link to view in IdeaLift dashboard
  • • Option to unlink if needed

Bidirectional Status Sync

IdeaLift automatically syncs status changes in both directions. When you update status in one system, the other system updates automatically.

Jira → IdeaLift

Jira Status→ IdeaLift
To Do / BacklogPlanned
In ProgressIn Progress
In ReviewIn Progress
Done / ClosedShipped
Won't DoRejected

IdeaLift → Jira

IdeaLift Status→ Jira
Captured / InboxBacklog
PlannedTo Do
ApprovedIn Progress
ShippedDone
RejectedWon't Do

Note: Status mapping is intelligent and adapts to your Jira workflow. IdeaLift finds the best matching transition based on available options in your project's workflow.

Categories

When sending an issue to IdeaLift, you can categorize it:

Feature
New functionality
Bug
Something broken
Improvement
Enhance existing
Research
Investigation
Other
Miscellaneous

The category auto-selects based on the Jira issue type (e.g., Bug issues default to "Bug").

What Gets Captured

When you send a Jira issue to IdeaLift, the following information is captured:

Captured

  • ✓ Issue summary (title)
  • ✓ Description (converted from ADF)
  • ✓ Issue type (Bug, Story, etc.)
  • ✓ Priority level
  • ✓ Current status
  • ✓ Project name
  • ✓ Reporter name
  • ✓ Labels
  • ✓ Link back to Jira issue
  • ✓ Your notes (optional)

Not Captured

  • ✗ Attachments
  • ✗ Comments
  • ✗ Worklogs
  • ✗ Custom fields
  • ✗ Subtasks
  • ✗ Linked issues

Troubleshooting

"Send to IdeaLift" doesn't appear in the menu

Make sure the app is installed on your Jira site. Go to Jira Settings → Apps → Manage apps and verify IdeaLift is listed and enabled.

"Jira site not connected" error

Your Jira site needs to be connected to an IdeaLift workspace. Log in to IdeaLift, go to Dashboard → Connections, and connect your Jira site.

Status not syncing to Jira

IdeaLift can only transition issues if a valid transition exists in your Jira workflow. If you have a custom workflow, some transitions may not be available. Check your project's workflow configuration.

Getting "Too many requests" error

Wait a few minutes and try again. This happens when many requests are made in a short time.

Privacy & Security

  • 🔒All data transmitted over HTTPS encryption
  • 🔒We only access issues you explicitly send to IdeaLift
  • 🔒No bulk data export or scanning of your Jira projects
  • 🔒Link data stored securely in Atlassian's Forge storage
  • 🔒You can unlink issues at any time

Need Help?

We're here to help you get the most out of IdeaLift for Jira: