Configure Clockwork

Once you have installed Clockwork, you can configure global and project settings to control how time is tracked.

Global vs Project vs User Settings

Clockwork has global settings, project settings and settings which can be configured on either a global or a project level. In these cases, projects will inherit the global setting by default, but can be changed from the Project Settings.

  • To configure global settings, log in as a Jira Administrator and go to Jira Settings > Apps > Clockwork Configuration.

  • To configure project settings, log in as a Project Administrator and go to Project > Project Settings > Clockwork.

  • A user can configure their own Working Hours, by going to Apps > Clockwork in the main Jira menu and selecting Working Hours.

Set Clockwork as the Time Tracking Provider Global

You can set Clockwork to be the time tracking provider in Jira. This is optional, but is required by many Clockwork features. To set Clockwork as the time tracking provider, log in as a Jira Administrator and go to Jira Settings > Issues > Time tracking. Select Clockwork Automated Timesheets from the Time tracking provider dropdown.

Clockwork Settings

Active Projects Global

Clockwork can run on any or all projects in your Jira instance. To enable Clockwork, go to Jira Settings > Apps > Clockwork Configuration and select the Active Projects tab. Use the toggles on this tab to enable Clockwork on all projects by default, or to only enable Clockwork on selected projects.

Time Tracking GlobalProject

The next tab is Time Tracking. These settings allow you to control how Clockwork tracks time.

  • Turned off If you select to have time tracking turned off, Clockwork will not be shown on individual issues, users will not be able to start or stop timers, and any timers that were previously running will be deleted. You will still be able to use Clockwork reports including My Work, Timesheets and Reports.

  • Manual timers allow users to start and stop a timer on an issue, or to manually log a block of time on an issue.

  • Automatic timers start and stop based on the issue status. When an issue has an assignee and is transitioned to an active (see below) status, the timer will start. When the issue is transitioned to an inactive status, the timer will stop.

  • Multiple timers can run simultaneously for the same user, or you can automatically stop all other timers when a new timer starts for a given user. We advise you to disable multiple timers.

  • Time rounding mode allows you to indicate if you want to record timers that ran for less than one minute; and if you want to round timers up to the nearest quarter of an hour.

  • Stop all issue timers when work is done will stop all timers from running when the issue is transitioned out of an active status, regardless of whether or not a user (who may or may not be the assignee) has a timer running on the issue.

Active Statuses Project

If you are using automatic timers, you can configure which statuses are considered active (the timer will run when the issue is in these statuses). Clockwork will allow you to select statuses from all workflows used by the project. Therefore, this setting may only be configured at the project level.

By default, Clockwork will use any status that is part of the In Progress status category as an active status. If you wish to change the active statuses, select the Override status categories radio button, then drag the desired statuses to the Active column.

Worklogs Global

If you are allowing users to log work manually, worklogs let you specify;

  • If the user needs to enter a description of the work performed

  • Whether users can report time in the future

  • How far in the past users can log time

Integrations Global Project

Clockwork creates a new custom field called Clockwork Timers that is available to all projects where Clockwork is enabled. If an automatic timer is running (the issue is in an active status and has an assignee) then the current amount of time logged against the issue will be stored in the field. You can also add this field to cards in your Jira boards.

In Service projects, the Integrations tab of the Project settings will allow you to enable a setting that will show the Time Spent on an issue/request the customer portal. This is a convenient way to show customers that you are actively working to resolve a request.

Working Hours Global Project USER

Use this setting to tell Clockwork your default working hours.  When a Clockwork timer is running, Clockwork will use the Working Hours to calculate the actual amount of time that the issue was being worked on. 

Working Hours can also be used with other Clockwork features such as Log Work and Timesheet to highlight users who are working outside of the intended hours.

Working hours can be set at three different levels:

  • The global setting allows you to enter the working hours for your organization.

  • You can also set work hours for the project from the Clockwork Project settings menu.

  • A user can configure their own Working Hours, by going to Apps > Clockwork in the main Jira menu and selecting Working Hours.

Clockwork timers will always use the most specific calendar available (assignee, then project, then global).

You can also integrate with any iCal compatible calendar (such as Google Calendar) to manage your days off. Any whole day event in the calendar will be treated as a holiday. There's currently no support for part-day events.

To sync with a Google Calendar, click on the options menu (three vertical dots) to the right of the calendar name and select Settings. Copy the url for the Public address in iCal format and paste it into the Clockwork Holiday Calendar field.

To sync with an iCal Calendar, right click on a calendar and select Copy URL to Clipboard. Paste the URL into the Clockwork Holiday Calendar field.

Mobile Version Global

Use the toggle to enable Clockwork in Jira Mobile.

Note that if this setting is enabled, when you view an issue in New Issue View on a desktop/laptop, Clockwork will be displayed on the right hand panel (even if it is also displayed in the main panel).