/
Automatic Timer

Automatic Timer

Forge version only — Availability Notice
This feature is available exclusively on the Forge version of Timesheet Tracking for Jira.
It will be rolled out automatically for new installations starting July 1st, 2025, or via manual update which is progressively available for existing clients thourgh the next few weeks.

Migration to Forge (Release Note)

⏱ Auto-Timer: Automate Time Tracking Based on Issue Status

Automatically track time without manual input. The Auto-Timer feature in Timesheet Tracking for Jira enables time tracking based on issue lifecycle, ensuring accurate and effortless logging aligned with your workflows.

Whether you're aiming to reduce friction for end-users or enforce tracking consistency across teams, Auto-Timer provides a smart and scalable solution.

⚙️ Step 1 : Accessing Auto-Timer Settings

To access timer configurations:

  1. Navigate to Timesheet → Settings from the plugin's main menu.

image-20251022-095826.png

 

  1. In the left sidebar, click Timers.

  2. The Timer Settings page appears, allowing you to manage both:

    • Manual Timer rules

    • Project-based Auto-Timer configurations

At this stage, you’ll also see a list of projects where Auto-Timer is already enabled. To activate it for a new project, click on the corresponding tile to begin setup.

image-20251022-095914.png

⚙️ Step 2 : Navigate from the Project Directly

You can enable Auto-Timer directly from a project:

  1. Open the Projects dropdown and select your project.

  2. Click Project settings.

image-20251022-102738.png

 

  1. In the sidebar under Apps, locate and select Timesheet Tracking for Jira.

  2. This will open the Auto Timer Settings for that specific project and Enable Auto timer in the top right of the screen.

image-20251022-103523.png

 

This view allows you to directly enable or disable Auto-Timer per project and customize all tracking rules.

🔧 Step 3 :Configuring Auto-Timer Per Project

Once inside a project’s Auto-Timer configuration screen, you can define when time should automatically start and stop based on issue statuses.

1. Respect Working Hours and Holidays

Toggle whether tracked time should align with user-defined working hours and holidays:

  • Enabled → Only count time during business hours, excluding weekends/holidays.

  • Disabled → Track full time between start and stop statuses, regardless of schedule and holiday.

Recommended for organizations operating under labor regulations or needing compliance with working time policies.

When the “Respect employee schedule and holidays” option is enabled, the Auto-Timer intelligently aligns the tracked time with the user’s:

  • Assigned Schedule (configured daily working hours)

  • Assigned Holiday Set (includes public and private holidays)

🕒 In this mode, time tracking is strictly limited to business hours and excludes non-working days, ensuring compliance with organizational policies, labor regulations, or contractual agreements.

❗When this option is disabled, Auto-Timer switches to a strict tracking mode: time is counted continuously between the defined start and stop statuses, regardless of any assigned schedules or holidays.

🔗 Need more details about working hours and holidays setup?
Refer to the https://cappsule.atlassian.net/wiki/pages/resumedraft.action?draftId=2952101894&draftShareId=9a4ddb87-74fe-43a4-aa9a-3a67496828fd&atlOrigin=eyJpIjoiNjI1MDJmZWI0ODFiNDgxZmJiMzkwYzBkOWYyNmQzMGIiLCJwIjoiYyJ9 documentation to learn how to configure user schedules and assign holiday calendars.
These settings directly affect Auto-Timer behavior when the “Respect employee schedule and holidays” option is enabled.

2. Define Active Statuses (Triggering Conditions)

You can either:

  • Use default Jira status categories:

    • Idle: No timer (To Do)

    • In Progress: Timer runs

    • Done: Timer stops and converts to a worklog.

  • Or customize per project using drag-and-drop.
    You can assign any status from your workflow to one of these categories:

    • Idle

    • In Progress

    • Done

Example: You can track time during “QA Review” or “Testing” by assigning them to In Progress, and exclude “Blocked” by leaving it in Idle.

3. JQL-Based Conditions (Optional)

Add a JQL condition to scope Auto-Timer to specific issues.

Examples:

  • labels = auto-track

  • assignee = currentUser()

  • project = ACME AND component = Backend

If left empty, the rule applies to all issues in the selected project.

🧩 Step 4 : Visualizing Auto-Timer Activity

Once Auto-Timer is in use, you can view and monitor its activity via the Timers view.

Navigate to Timesheet → Timers to explore all current and past tracked sessions. The view is split into three columns:

Column

Meaning

Column

Meaning

Running

Issues currently being tracked automatically

Paused

Timers that were interrupted (due to status change)

Converted

Completed timers converted into worklogs

image-20251027-135438.png

Each timer includes details like:

  • Duration

  • Mode (manual / #AUTO)

  • Linked issue and summary

  • Start and end time

This dashboard provides full visibility on how Auto-Timer behaves in real-time, ensuring transparency and traceability.