2-way integration with Jira
Our free Jira app enables you to track time on issues directly from Atlassian Jira with just one click.
Clockify plugin for Jira is available in the Jira web app, Jira mobile app for Android and iOS, as well as Jira macOS desktop app.
Install the Clockify Jira app #
Jira admin needs to install the Clockify app from the official Atlassian Marketplace.
Follow the instructions for your specific Jira and Clockify app setup.
Jira Cloud + Clockify Cloud
- Go to the Atlassian Marketplace and find Clockify (make sure you installed the app developed by CAKE.com)
- Click Get it now
- Choose a site where you want to install the app from the dropdown list
- Follow the prompts to review permissions and complete the installation
Jira Data Center (Jira Server) + Clockify Cloud
Time tracking for Jira Data Center via Clockify will be available soon.
Jira Cloud + Clockify
In your Jira Cloud instance:
- Go to Manage apps > Settings
- Choose Enable development mode and click Apply
- Go to Manage apps > Install private app
- Choose Jira from the dropdown
- In App descriptor URL enter the URL for your Clockify plugin and click Install app
Getting started #
After the app is installed, the Clockify timer button will appear on all Jira issues.
Connect your accounts #
The first time you click on the Clockify timer button, you will be asked to log in.
Manage your app #
You will receive a notification after installation.
Go to the Manage app in the notification and then Take me there to go to the Administration page where you can manage app details and settings.
Only Jira admins can manage apps in Jira and install the Clockify app.
Regional server hosting #
In addition to global hosting, you can choose to host your data in other specific regions.
Jira Cloud + Clockify on regional data center
If your Clockify data is hosted on one of the regional centers, follow these steps to integrate Clockify with Jira:
- First, you need to complete the installation process (link to Jira Cloud + Clockify Cloud)
- Then when logging in, from the dropdown, choose the specific region where your Clockify data is hosted:
- After you log in, you’ll see a list of all the workspaces hosted in that region
- Now, choose the Clockify workspace you wish to integrate
Track time #
When you click on the Clockify timer button, on an issue, you can choose between the Timer and Manual mode.
Timer mode #
Timer helps you track time you spend working on tasks by measuring specific time intervals.
To start the timer:
- Choose task
- Click to expand Clockify tracker in the task description
- Make sure you’re in the Timer tab and start the timer
- Click the Stop button when you’re done
The timer is synced to your Clockify account, across all devices and can be stopped in Jira or from any of the Clockify apps (browser, mobile, or desktop).
If you start a new timer on a different Jira issue, the previous timer will automatically stop and a new one will start.
Manual mode #
If you forgot to start the timer, or you prefer to fill in all your work hours in one go, you can use manual mode.
Owners/admins can disable manual mode and enable the Force timer in the Clockify Workspace settings.
To add time manually:
- Choose task
- Click to expand Clockify tracker in the task description
- Make sure you’re in the Manual tab
- Enter time range and click Add time
If you have multiple workspaces in Clockify, you can select the desired workspace before adding the time entry.
What gets recorded in Clockify #
When you start the timer, Clockify automatically picks up the following information from Jira and syncs it to your time entry:
- Description: The Jira issue key number and issue title are used as a time entry description
- Project: Your project in Jira is mapped to a Project in Clockify
- Task: The Jira issue key is used as a task in Clockify
- Tags: Issue types (bug/task/story) and labels in Jira are converted into tags in Clockify
You can manually change the task you are working on directly from Jira by clicking on the task name and selecting the one you want from the dropdown.
Tracking time on a Child issue in Jira will be picked up as a task in Clockify with a tag Subtask.
For the integration to work correctly, a corresponding project or task needs to already exist in Clockify, or the user needs to have permissions to create new projects and tasks in Clockify Workspace settings.
Important to note #
- Time entries stopped in Jira will be added to the Jira work log. Also, changes you make in Jira work log will be synced to Clockify and vice versa
- Information about an Epic or Sprint will not be recorded. However, tracking time directly on an Epic will create a time entry with tag Epic
When Force timer is enabled, duration changes to time entries will not be applied in the Work log. If entries are locked, non-admin users cannot make changes to any details.