--- title: Jira Integration in Toggl description: Jira integration Toggl 2.0 --- [Skip to content](https://docs.toggl.com/jira-integration-in-toggl#main-content) English Show submenu for translations [![logo-dark](https://docs.toggl.com/hs-fs/hubfs/logo-dark.png?width=223&height=85&name=logo-dark.png)](https://docs.toggl.com/?hsLang=en) Open main navigation Close main navigation - English Show submenu for translations - [Go to Toggl](https://focus.toggl.com/) [Go to Toggl](https://focus.toggl.com/) How can we help you? - There are no suggestions because the search field is empty. 1. [Toggl 2.0 Knowledge Base](https://docs.toggl.com/?hsLang=en) 2. [API & Integrations](https://docs.toggl.com/api-integrations?hsLang=en) # Jira Integration in Toggl ## The Jira integration lets you sync your Jira projects, issues, sub-tasks, and labels into Toggl ### Overview The Jira integration lets you sync your Jira projects, issues, sub-tasks, and labels into Toggl. Once connected, your Jira projects appear as Toggl projects, issues become tasks, sub-tasks become subtasks nested under their parent task, and labels become tags, all kept in sync automatically. During setup you can choose what comes in: switch off entity types you don't need, or use a JQL filter to limit which issues are imported. By default everything is imported. When something changes in Jira (like a new issue being created), it shows up in Toggl 2.0 near-instantly. This means your team can plan and track work in Toggl 2.0 without manually recreating their Jira data. The integration is set up by a workspace admin and includes an optional step to import Jira users so that issue assignments carry over into Toggl. If your Atlassian account can access more than one Jira site, you choose which site to sync from during setup. **The sync is one-way: from Jira to Toggl.** Changes made in Toggl are not pushed back to Jira. ### Feature Availability Available on **Premium** plans only. ### How It Maps | Jira | Toggl | | --- | --- | | Project | Project | | Issue | Task | | Sub-task | Subtask (nested under its parent task) | | Label | Tag | | Assignee | Task assignee (requires user import) |   Each imported project and task includes a link back to the original item in Jira. Epics, stories, and other standard issue types all become tasks under their project, with no link between them. Only Jira sub-tasks are nested under a parent task, matching the one level of subtasks Toggl supports. ### Setup #### How to Connect Jira 1. In the **Admin Settings**, go to **Integrations** and connect **Jira** **![connect Jira](https://docs.toggl.com/hs-fs/hubfs/Knowledge%20Base%20Import/connect%20Jira-1.png?width=644&height=242&name=connect%20Jira-1.png)** 2. On Atlassian’s consent screen, select the Jira site or sites you want Toggl to access, and accept. Toggl can only see the sites you select here. Being a member of a site is not enough. ![Bildschirmfoto 2026-03-12 um 14.56.15 (1)](https://docs.toggl.com/hs-fs/hubfs/Knowledge%20Base%20Import/Bildschirmfoto%202026-03-12%20um%2014_56_15%20(1)-1.png?width=670&height=377&name=Bildschirmfoto%202026-03-12%20um%2014_56_15%20(1)-1.png) 3\. You are redirected back to Toggl ### **How to Choose Which Jira Site to Sync** If your account can reach two or more Jira sites, the first step of the setup wizard shows a **Sync data from** dropdown. The site Toggl would have picked is already selected. To use a different site, pick it from the dropdown. The rest of setup then uses that site: the member import, the review preview, and the first sync. If your account reaches only one site, there’s no dropdown. You see a **Data will be synced from** line that names the site. **Don’t see the site you want?** Jira only lists the sites you gave Toggl access to on Atlassian’s consent screen. To add another site, run the connect flow again and select that site on the consent screen. ### How to Import Users from Jira After connecting, Toggl prompts you to import members. This step is optional but recommended: without it, task assignments will not sync. 1. Follow the link to your **Jira user directory** and export your users as a CSV 2. You'll receive an email from Atlassian with the CSV download 3. Back in Toggl, upload the CSV. Toggl identifies the users and their email addresses 4. Select the users you want to import and continue **Important:** If you skip the user import, projects and tasks will still sync, but they will not be assigned to users in Toggl. **Note:** The member CSV is tied to the site you selected. If you switch to a different site after importing a CSV, the imported members are removed. Export and import the CSV for the new site. ### How to Choose What Gets Imported On the last step of the setup wizard, before the first sync starts, you can limit what comes into Toggl. The two options below work together: the JQL filter decides which issues Jira sends, and the entity switches decide which of the resulting projects, tasks, subtasks, and tags are saved. For example, if your query matches issues but the Tasks switch is off, the projects still come in and the issues don't. #### Entity types The last wizard step shows four switches: **Projects**, **Tasks**, **Subtasks**, and **Tags**. All start on. You can turn off the ones you don't need, and at least one always stays on. The **Subtasks** tab lists sample sub-tasks with their parent task's key. Subtasks only sync together with tasks: if you switch **Tasks** off, the Subtasks tab shows "Tasks are off, so subtasks won't sync either." #### JQL filter Above the entity tabs there is a box where you can write a JQL query. Click **Apply filter** and the Projects, Tasks, and Subtasks counts update, so you can see what will be imported before you finish. Leaving the box empty imports everything. - If Jira rejects the query (bad syntax, or a project or value that doesn't exist), Toggl shows Jira's own error message. You can't finish setup until the query is fixed. - If the query is valid but currently matches nothing, Toggl warns you to double-check names and keys. You can still continue. - If the query matches more issues than one sync can handle, Toggl warns you with both numbers. You can still continue. - A sub-task is only imported if its parent issue also matches the query. A sub-task whose parent is filtered out has nothing to be nested under, so it is skipped. - The Tags count never changes: Jira labels are always imported for the whole account. ### How to Start the Sync 1. Review the **mapping overview** showing what will be imported ![Bildschirmfoto 2026-03-12 um 14.56.49](https://docs.toggl.com/hs-fs/hubfs/Knowledge%20Base%20Import/Bildschirmfoto%202026-03-12%20um%2014_56_49-1.jpg?width=670&height=377&name=Bildschirmfoto%202026-03-12%20um%2014_56_49-1.jpg) 2. Confirm and start the sync 3. Check the **sync log** to verify everything imported correctly ![Bildschirmfoto 2026-03-12 um 14.57.11](https://docs.toggl.com/hs-fs/hubfs/Knowledge%20Base%20Import/Bildschirmfoto%202026-03-12%20um%2014_57_11-1.jpg?width=670&height=377&name=Bildschirmfoto%202026-03-12%20um%2014_57_11-1.jpg) Once complete, your projects, tasks, subtasks, and tags appear in Toggl. In the sync log, Jira sub-tasks show the type **Subtask**. ### Ongoing Sync After the initial import, new issues created in Jira sync to Toggl automatically and near-instantly, including project assignment. Remember that the sync is **one-way** — only changes in Jira are reflected in Toggl, not the other way around. Sub-tasks sync the same way, and Jira stays in charge of the hierarchy: - Move a sub-task to another parent in Jira and it moves to that parent task in Toggl. - Convert a sub-task to a standard issue in Jira and it becomes a top-level task in Toggl. Convert a standard issue to a sub-task and it becomes a subtask in Toggl. - If you move a synced subtask under a different task in Toggl, the next change to it in Jira puts it back under its Jira parent. ### If Your Import Filter Stops Working A JQL filter that worked at setup can stop working later. Two things can happen: - **Jira rejects the query**, for example because a field it uses was removed. The next sync fails, and the integration card changes from Connected to **Sync stopped**, showing Jira's error. Click **Fix filter** to open the query pre-filled and correct it. - **The query still works but matches nothing**, for example because a project was renamed or deleted, a sprint closed, a label was removed, or access was lost. Jira reports no error in this case, so Toggl watches for it: after 24 hours with no matches, the card shows **Sync stopped** with "filter no longer matches any issues" and the same **Fix filter** option. If matching issues come back sooner, nothing happens. In both cases, the corrected query must work in the preview before you can save. Saving an empty box removes the filter, and syncing continues without it. ### Tracking Time on Jira Issues The [Toggl browser extension](https://community.toggl.com/t/toggl-focus-browser-extension/3770) lets you track time directly from Jira without leaving your current workflow. When the Jira integration is set up, the extension automatically fills in the correct project, task title (including the Jira task identifier), and any synced tags — so you don’t have to think about metadata. **There are three ways to log time from Jira:** - **Presets** — Click a preset (e.g. 30 minutes) to open an overlay pre-filled with the start and end time for that duration. The project, task title, and tags are assigned automatically. - **Play button** — Start a live timer on any Jira issue. When you stop and open the extension, the time entry already has the correct project and task assigned. - **Drag** — Drag to select a custom duration (e.g. 3 hours). This opens the same overlay as presets, pre-filled with the selected time range and all metadata auto-assigned. All time tracked through the extension is synced to Toggl 2.0 with the correct metadata — no manual entry required. ### Edge Cases & Considerations - **User import is required for assignment sync.** If users are not imported, tasks sync without assignees. - **One-way sync only.** Data flows from Jira to Toggl. Creating or editing tasks in Toggl does not update Jira. - **Import settings are chosen during setup only.** Nothing removes items already imported, so changing the entity switches or filter later would leave stale projects and tasks behind. There are two exceptions: fixing a filter that stopped syncing, and editing a filter that has never matched anything. In the second case the integration card says "This import filter hasn't matched any issues yet" and offers **Edit filter**, since nothing was imported under it. - **Sub-tasks imported before subtask support became subtasks on their next update.** Earlier, Jira sub-tasks were imported as top-level tasks. They are converted to subtasks automatically the next time anything about them changes in Jira; untouched ones stay top-level until then. - **A sub-task can't sync if its parent can't hold subtasks.** If the parent task was deleted in Toggl, or is itself a subtask, the sub-task isn't changed and the sync log shows "parent task cannot hold subtasks". Likewise, a task that already has its own subtasks or has **Sum subtask totals** on can't be turned into a subtask. - **Sub-tasks skipped by the filter catch up on their next change.** If a sub-task was skipped because its parent didn't match the JQL filter, and the parent later starts matching, the sub-task syncs the next time it changes in Jira. - **The Jira site is chosen during setup only.** After the integration is activated, you can’t change the site from the integration settings. - **Only sites you authorized are listed.** If a site is missing from the dropdown, reconnect and select it on Atlassian’s consent screen. - [Getting started](https://docs.toggl.com/getting-started?hsLang=en#main-content) - [Start here](https://docs.toggl.com/getting-started?hsLang=en#start-here) - [Quickstart Guides](https://docs.toggl.com/getting-started?hsLang=en#quickstart-guides) - [Set up your Workspace](https://docs.toggl.com/getting-started?hsLang=en#set-up-your-workspace) - [Toggl Guides for Toggl Track and Toggl Plan users](https://docs.toggl.com/getting-started?hsLang=en#toggl-guides-for-toggl-track-and-toggl-plan-users) - [Using Toggl, page by page](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#main-content) - [Timer](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#timer) - [Reports](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#reports) - [Projects](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#projects) - [Tasks](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#tasks) - [Timeline](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#timeline) - [Members](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#members) - [Approvals](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#approvals) - [Time Off](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#time-off) - [Profile Settings](https://docs.toggl.com/using-toggl-page-by-page?hsLang=en#profile-settings) - [Admin Settings & Security](https://docs.toggl.com/admin-settings-security?hsLang=en#main-content) - [Workspace Setup](https://docs.toggl.com/admin-settings-security?hsLang=en#workspace-setup) - [Tracking & Rates](https://docs.toggl.com/admin-settings-security?hsLang=en#tracking-rates) - [Single Sign-on](https://docs.toggl.com/admin-settings-security?hsLang=en#single-sign-on) - [Subscription & Billing](https://docs.toggl.com/subscription-billing?hsLang=en) - [Toggl Apps](https://docs.toggl.com/toggl-apps?hsLang=en#main-content) - [Mobile](https://docs.toggl.com/toggl-apps?hsLang=en#mobile) - [Desktop](https://docs.toggl.com/toggl-apps?hsLang=en#desktop) - [Browser Extension](https://docs.toggl.com/toggl-apps?hsLang=en#browser-extension) - [API & Integrations](https://docs.toggl.com/api-integrations?hsLang=en) - [Troubleshooting & FAQs](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#main-content) - [My Toggl Acount](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#my-toggl-acount) - [Common Questions](https://docs.toggl.com/troubleshooting-faqs?hsLang=en#common-questions) Copyright © 2026. Toggl. [Privacy Policy](https://toggl.com/legal/focus/privacy/)