Jira Integration
Connect DevStride to Jira Cloud to import issues and keep them up to date with changes made in Jira.
On this page
Use the Jira integration when a team's work already lives in Jira Cloud and you want it visible and reportable in DevStride without re-keying it. DevStride imports the Jira projects you choose and keeps the imported items in step with Jira: issues, comments, issue links, and sub-tasks.
Setup has two stages: create a Credential that connects a Jira site, then map that site's projects and issue types onto your DevStride data model and import.
Jira Cloud only
The integration supports Jira Cloud (Atlassian Cloud). There is no setup path for Jira Server or Jira Data Center.
To reach the integration, open Configure Settings → Integrations. The Integrations group lists Credentials, GitHub, Slack, Microsoft Teams, Database Access, Identity Providers, Jira, and Azure DevOps. You need Manage Integrations to see the Jira and Credentials entries.
Before you start#
- You need the Manage Integrations permission (Owner and Admin have it by default).
- The Atlassian account you connect must grant the manage:jira-project scope. Only sites that grant this scope appear as connectable accounts.
- To have issue-link changes reach DevStride, you must be a Jira admin, because the issue-link webhook has to be created manually in Jira (see Set up the issue-link webhook).
- Sync runs only while your DevStride subscription is active. Webhook-driven updates are skipped when the subscription is inactive.
1 - Create a credential and connect Jira#
Credentials store the authentication DevStride uses to talk to Jira.
- Go to Configure Settings → Integrations → Credentials.
- Click Add to open the Add Credential dialog.
- Enter a Label to identify the credential (for example, John Doe's JIRA).
- Set Provider to Jira.
- Click Create. An Atlassian OAuth popup opens; complete it to authorize DevStride. Finish it in the browser where you started it: if you send the link to someone else, DevStride refuses it and connects nothing.
After authorizing, each Jira site you have access to appears in the Credentials list. Use Connect to install DevStride on a site; once installed, the action shows Connected, and you can use Configure or Disconnect as needed.
Provider shared with Azure DevOps
The Credentials page and the Add Credential dialog are shared with the Azure DevOps integration. Make sure Provider is set to Jira when you are connecting a Jira site.
If you open the Jira page before connecting a site, you will see a Connect Jira prompt inviting you to connect your Jira account. Choose Connect to get started to begin.
2 - Configure projects and mappings#
Once a Jira site is connected, open Configure Settings → Integrations → Jira. Each connected Jira instance appears as an expandable section showing its base URL, along with these controls:
- Webhook Setup — opens the guide for setting up the issue-link webhook.
- Raw config — view the underlying configuration.
- Save changes — save your mapping configuration.
- A Configuration / Import Jobs toggle to switch between mapping setup and import history.
- Disconnect and + Connect another organization.
Select projects to set up#
Under Select Projects to Setup, toggle each Jira project on or off. Only the projects you enable are configured for import. Enabling a project expands it so you can configure its mappings.
Map each enabled project#
For every enabled project, set the following:
- Status Collection — Select a Status Collection that should be used to set up the boards for this project.
- Workstream — Select a Workstream where the items for this project should be placed. This is the parent Workstream into which imported items land.
Then, for each entry in the Jira Issue Types column, choose the DevStride Item Type the issue type should map to, and configure the mapping sub-sections:
- Statuses — map your Jira board columns to DevStride board statuses.
- Custom Fields — map your Jira fields to DevStride custom fields.
- Tags — map your Jira labels to DevStride tags.
- Priority Levels — map your Jira priorities to DevStride priority levels.
Mapping is defined per Jira issue type, so each issue type can resolve to its own Item Type and field mappings.
Auto-map with Infer
DevStride can suggest mappings for you. Infer project mappings fills in a whole project; Infer all issue types and Infer issue type mappings match issue types to Item Types; and each section has its own Infer status / field / tag / priority / user mappings. Where you have already mapped a similar project, choose Infer from another project to copy its choices. Review the suggestions before saving.
Below the project list, the Global Mappings section holds User Mapping (Map your Jira users to DevStride users), which applies across all projects.
When your mappings are ready, click Save changes.
3 - Import a project#
After saving your mappings, click Initiate import for a project to bring its issues into DevStride. Imports run as jobs that you can track under the Import Jobs tab.
Jira is the source of truth for imported items
Items imported from Jira are overwritten by subsequent Jira updates. Any local changes you make in DevStride to a synced field can be replaced the next time the source issue changes in Jira.
If you change a project's mappings after it has already been imported, DevStride prompts you to optionally re-import that project so the changes take effect.
Set up the issue-link webhook#
Sync is one-way, from Jira into DevStride. Importing brings issues into DevStride, but keeping issue-link changes flowing in requires a webhook in Jira. DevStride cannot create this issue-link webhook automatically, so a Jira admin must add it manually.
- In the connected Jira instance section, click Webhook Setup to open the Jira Cloud Webhook Setup Guide.
- Follow the guide to create a webhook in Jira Cloud named DevStride Issue Links Integration.
- Subscribe the webhook to the Issue link: created and Issue link: deleted events.
Once the integration is active, DevStride keeps work synchronized using these Jira events:
- Issue created, updated, and deleted
- Issue link created and deleted
- Comment created, updated, and deleted
Webhook deliveries are verified#
The webhooks DevStride registers when it imports a project carry a per-registration secret in their callback URL, and every delivery is checked against it before anything is written — a POST that does not present the right secret is refused and nothing in your organization changes. You do not manage this secret; DevStride mints a fresh one each time it registers a project's webhooks, and importing (or re-importing) a project rotates it. Projects imported before this check existed keep syncing as they always have; re-import such a project to move it onto a verified registration.
Jira sub-tasks sync into DevStride as sub-items. If a Jira issue changes from a standalone issue into a sub-task, DevStride removes the original work-item link and creates the corresponding sub-item link.
Working with imported items#
When an item has been imported from Jira, it shows an imported from JIRA badge (a down-arrow icon). Selecting the badge opens a popup with:
- A message such as This item was imported from JIRA (or This workstream houses items imported from JIRA at the workstream level).
- View source item — deep-links to the original issue in Jira.
- Sync — triggers a manual synchronization of the item.
- Item Metadata, including the Jira URL.
- A reminder that local changes are overwritten by source updates.
Imported items are read-only in DevStride: you can open their relationships and blocker panels, follow the board link, and view everything, but adding or removing relationships, setting a blocker, and other edits stay blocked.
Archived sprint boards and folders#
You can archive a sprint board, or the folder of boards a Jira project created, from its menu in Plan Delivery. DevStride never recreates it, and the sync carries on past it: the sprint import skips an archived sprint, and an issue in that sprint is placed on the project's board instead, as an issue with no sprint is. Unarchive the board or folder and its sprints take issues again, with no second board made. See Boards and folders synced from Azure DevOps or Jira.
Disconnecting#
You can disconnect at the project or instance level:
- Disabling a project, or disconnecting a Jira installation or credential, prompts you to choose how existing items should behave.
- Because imported items are linked to their Jira source, disconnecting after an import can remove or detach data in DevStride. Review the disconnect options carefully before confirming.
If the connection's access is revoked#
If the Jira credential's authorization expires, or someone revokes it in Jira, DevStride tells you so directly: you'll see a message asking you to reconnect the integration to restore access, rather than a generic failure. Reconnect the credential in Configure Settings → Integrations → Credentials and syncing resumes.
DevStride only remembers what Jira successfully returned, so once access is back it is picked up on the very next request. A moment of lost access no longer leaves Jira screens failing for hours afterwards. What DevStride remembers is also kept separately for each Jira site, so two sites never see each other's issue types or fields.
Related#
- GitHub
- Connect AI & the MCP Server — the MCP tools
list_integration_installations,create_integration_installation, andsubmit_integration_jobwork with the same Jira installations