Send issues to Linear and Jira

The Issues board collects data problems that AI agents and people find. If your team plans work in Linear or Jira, you can have Lightdash open an issue there for each finding so nothing needs to be copied across by hand. Once connected:

• New findings create an issue automatically. Every new AI-filed finding, and every issue filed by hand on the board, gets a Linear or Jira issue in the background.
• Existing findings can be exported in one click. Open findings that were on the board before you connected are not exported on their own. Use Create issues for existing findings to catch up.
• Each issue links both ways. The Linear or Jira issue carries an Open in Lightdash link back to the finding, and the finding on the board shows the issue identifier (for example AE-142 or DATA-57) as a link to the tracker.
• Status is not synced. Closing an issue in Linear or Jira does not change the finding on the board, and resolving a finding does not close the issue. Treat the tracker as the place where work is planned and the board as the place where evidence lives.

You can connect Linear, Jira, or both. With both connected, every finding gets one issue in each tool.

​

What an exported issue contains

Each exported issue uses the finding’s title and a description made of: The link is also attached to the issue as a Linear link or a Jira web link, so it stays visible when the description is edited. A finding is exported once per tool. Recurrences of an already-exported finding do not create a new issue; the existing issue keeps its link and the board’s Recurs N× count goes up.

​

Where the settings live

1. Go to Settings → Ask AI → General.
2. Make sure Review AI agent turns is on. The export settings only appear while reviews are enabled.
3. Scroll to the Linear issues and Jira issues sections, below the Slack notification settings.

Only organization admins can connect a tracker or change the routing.

​

Linear

​

Connect Linear

Lightdash connects to Linear through a private OAuth app that you create in your own Linear workspace. No client secret is needed, and there is nothing to configure on the server.

1. In the Linear issues section, click Create Linear app. This opens Linear’s new-application page with the app name, callback URL, and grant type already filled in. Save the app in Linear.
2. Copy the app’s client ID from Linear.
3. Back in Lightdash, paste it into Linear OAuth client ID and click Connect Linear.
4. Approve the app in Linear. Lightdash asks for the read and issues:create scopes only.

You are sent back to the settings page with the section marked Connected and the name of the Linear workspace shown underneath.

​

Choose where issues go

Selections save as you change them. The toggle at the top right switches the export on and off. It can only be turned on once a team is chosen and at least one project is in scope, and it is switched on for you when you pick a team.

​

Export findings that already exist

Connecting Linear does not export findings that were already on the board. When you are happy with the routing, click Create issues for existing findings. Lightdash queues every open finding in the projects you selected that does not already have a Linear issue, and creates the issues in the background in small batches. Findings in Done and dismissed findings are not exported. The button is safe to click more than once. Findings that already have an issue are skipped, and Lightdash locks each finding while its issue is created so a backfill that overlaps with a review run cannot open duplicates.

​

Reconnect or remove

• Reconnect starts the Linear authorization again with the saved app. Use it after the app is reinstalled or its access is revoked in Linear.
• Remove deletes the connection and its token from Lightdash. Existing Linear issues are left as they are, and the links on the board keep working. Routing is cleared, so reconnecting later starts from a clean setup.

If the section shows Reconnect required, the saved connection can no longer create issues. This happens for connections made before app-based setup was introduced. Create a new private app, or reconnect with the same client ID, to continue exporting.

​

Jira

​

Connect Jira

Jira Cloud is connected through an Atlassian OAuth 2.0 app that you create in your Atlassian developer console. Both the client ID and the client secret are stored in Lightdash, encrypted, and used only for your organization.

1. Click Open Atlassian developer console and create an OAuth 2.0 integration.
2. Under Permissions, add the Jira API and tick the classic scopes read:jira-work and write:jira-work.
3. Under Authorization, set the callback URL to the one shown in Lightdash. It is https://<your-lightdash-url>/api/v1/jira/oauth/callback, and the copy button next to it puts the exact value on your clipboard.
4. Open the app’s Settings page in the console and copy the Client ID and Secret.
5. Back in Lightdash, paste both and click Connect Jira.
6. Atlassian asks you to sign in and approve the app. Sign in with an account that has Jira on the site you want to use. If the account has no Jira access on any site, Atlassian shows Access denied and the connection is not saved.

If the account can see more than one Jira site, the section shows a Select site badge and a Jira site picker. Choose the site that should receive review issues. With a single site, it is selected for you.

​

Choose where issues go

Selections save as you change them. The toggle at the top right switches the export on and off, and can only be turned on once a Jira project and issue type are chosen and at least one Lightdash project is in scope.

​

Export findings that already exist

The Jira section has the same Create issues for existing findings button as Linear. It queues every open finding in scope that does not already have a Jira issue and creates them in the background, skipping findings that are already linked.

​

Reconnect or remove

• Reconnect restarts the Atlassian authorization with the saved client ID and secret. Use it if the token was revoked, or to switch the connecting account.
• Remove deletes the connection, its token, and the stored client secret from Lightdash. Existing Jira issues and the links on the board are left as they are. Routing is cleared.

​

Which findings are exported

Issue creation runs on the scheduler. If Linear or Jira is unavailable, the job fails and is retried; findings whose issue was already created are not created twice.

​

Troubleshooting

• The Linear or Jira sections are missing. They only render while Review AI agent turns is on. Reviews are also paused while your organization has any bring-your-own AI provider key set, which hides the sections too.
• The export toggle is greyed out. Linear needs a team, Jira needs a project and an issue type, and both need at least one Lightdash project in scope. Pick those first.
• No issues appear for new findings. Check the toggle is on, that the finding’s project is in the selected projects, and that the finding is new rather than a recurrence. Findings that recur attach to the existing card and do not open another issue.
• Atlassian shows Access denied. The account you signed in with has no Jira product on any site. Sign in with an account that uses Jira on the site you want, then click Reconnect.
• Jira shows Select site. The connecting account can see several Jira sites. Pick one in the Jira site dropdown; issues are not created until a site is chosen.
• Linear shows Reconnect required. The connection predates app-based setup. Create a private app with Create Linear app and connect with its client ID.
• I changed the team or project and old issues did not move. Routing only applies to issues created after the change. Existing issues stay where they were created.

​

Related

• Issues: the board these exports are created from, and how findings are filed.
• Agent visibility: where Issues fits into admin visibility overall.
• Set up agents: enabling reviews and the rest of the Ask AI settings.