--- title: "Jira_ How to Connect and Collect" slug: "jira-how-to-connect-and-collect" tags: ["Jira", "Collect", "Connect"] updated: 2026-09-24T14:41:10Z published: 2026-09-24T14:41:10Z canonical: "docs.revealdata.com/jira-how-to-connect-and-collect" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Jira_ How to Connect and Collect ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-qj7ve08g.png) #### **In this article**: - Jira Overview - How to Connect and Collect Using Jira ## **Jira Overview** Jira is a project management and issue tracking platform used mainly by software development teams. Onna directly connects with Jira's API to collect all information in native format. | **Connector Features** | | --- | | **Authorized Connection Required?** No | **Is identity mapping supported?** No | | **Audit logs available?** Yes | **Admin Access?** Yes | | **Supports a full archive?** Yes | **Custodian based collections?** No | | **In-place preservations supported?** No | **Resumable sync supported?** Yes | | **Preserve in place with ILH?** No | **Syncs future users automatically?** No | | **Sync modes supported:** - One-time sync - Auto-sync - Auto-sync and archive | **Is file versioning supported?** No | | **Note:** Source Holds are supported by our Jira connector. | | | | **Types of Data Collected** | **Metadata Collected** | | All files are synced, including, but not limited to: - Issues-Including description, name, creator, updater, status, type, progress, priority, resolution, due date, summary, components, original estimate, time spent, votes, issue links, and custom fields. - Attachments - Comments | - **Project key-**The text identifier field used to identify the project - **Project name-** The name of a project - **Project type-** How a project is categorized in Jira. For example, software, business, or service desk | ### **Jira Considerations** - Since Jira native files are in html format, we take what Jira's API returns and format it like a ticket. ## **How to Connect and Collect Using Jira** When you’re ready to set up a sync using Onna’s Jira connector, follow the steps below: ### **Step 1** Navigate to the workspace where you want to set up your sync. Inside that workspace click on the ‘+’ icon in the upper right corner of the screen to ‘Add source’. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-5ts5c9p5.png) ### **Step 2** You will now see a list of all sources enabled for your organization. Find and select the ‘Jira’ source. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-a5l2wmwh.png) ### **Step 3** You’ll now name your source in the ‘Name’ field (a) and add your Jira site URL in the ‘Host name’ field (b). ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-h6q9up0d.png) ### **Step 4** You now have the option of connecting to Jira in three ways: - **Login with User and API Toke**n - enter your user name and then get an API token from Jira (b). To generate an Atlassian API token, follow the instructions. - **Login with User and Password** - enter your Jira username and password. - **Use an Atlassian service account** - use your organization’s configured Atlassian service account rather than an individual user’s credentials, and the connection can be renewed without needing to be manually re-authenticated. Existing API token and username/password data sources continue to work unchanged. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/image-JDETLY6J.png) ### **Step 5** Next, you’ll click on ‘Configure’ to select which data to sync and your preferred sync mode. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-w4rlgrsu.png) ### **Step 6** To configure you’ll first select the projects that you want to sync (a). Then, you’ll scroll to the bottom of the configuration window (b). ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-n8jxfvya.png) ### **Step 7** You’ll now click the arrow to the right of the ‘Synchronization mode’ field to select your sync mode from the dropdown that appears. ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-myfjxb2w.png) ### **Step 8** Next, you’ll set up your sync dates (a). If you’ve chosen a one-time sync you will enter a ‘Sync start date’ and a ‘Sync end date’. If you’ve chosen auto-sync or auto-sync and archive you will select a ‘Sync start date’ only. Note: Leaving the ‘Sync start date’ empty will lead to the collection of all available data Jira. Finally, you’ll click the blue ‘Done’ button (b). ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-v1e8yrw2.png) ### **Step 9** Your sync is now in progress and visible inside the workspace you added it to. To learn more, see the article "How to Monitor Your Source Sync Status.” ![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/jira_-how-to-connect-and-collect-image-bvzuui4h.png) ## ## Related - [Jira FAQs](/jira-faqs.md) - [Getting Started with Sources](/getting-started-with-sources.md) - [Onna Sync Modes](/onna-sync-modes.md)