Stopwatch issue panel


Overview

The Stopwatch issue panel displays the stopwatch state and accumulated time directly on the issue view. It shows whether the stopwatch is running, paused, or stopped, along with the time spent and pause time.

You can create multiple stopwatch panels with different event configurations.


Where it shows

The panel is in the context area of the issue view, under the title Stopwatch. It shows on issues of the projects and issue types of at least one panel configuration. If several configurations match, the panel shows all of them, ordered by Weight and then by name. Each configuration is shown under its name, also when it is the only one on the issue. Anyone who can see the issue can see the panel.

A panel limited to some projects shows there because the app marks these projects in a project property. Each app keeps its own property, so Sync panel visibility in one app leaves the panels of other apps installed on the same site as they are - see Panel visibility.


Creating a web panel

  1. Open the admin panel > Stopwatch tab > Web Panels
  2. Click Create
  3. Configure the panel on the tabs of the form (see reference below) and check it in the Preview
  4. Click Save - the app updates panel visibility for the panel’s projects by itself

Settings reference

Form layout

The form is split into tabs, like the field setting forms:

Tab Options
General Name
Scope Projects, Issue Types
Events Start, pause, stop and restart events, Allow restart from any state, Calculate type
Display Display mode, time format and the display toggles, including Show intervals
Calendar Default Calendar, Calendar Select Field
Advanced Weight, periodic update

If Save finds a problem, the form opens the tab with the first error, and every tab with an error is marked with an error icon. Next to the form is the Preview of the panel; the Two columns / One column button in the dialog header switches the layout, as in the field setting forms.

Options

The panel has its own events and calendar, independent from the field settings, and does not need a custom field.

Option What it does Default
Name Name of the configuration, unique, up to 150 characters empty
Projects, Issue Types Where the panel shows; empty - all all
Events Start Events, Pause Events, Stop Events, Restart Events, Allow restart from any state, Calculate type - see Event triggers reference and Restart behavior no events, off, All starts
Display mode Time spent, Time spent + Icon, Icon + Time spent, Pause time. The panel shows the value without the icon. Time spent
Time format One of the time formats 13h 48m 03s
Use rounding for display Cuts the time down to the step of the format on
Show zero value Off - the panel is hidden on issues where the stopwatch has not started yet on
Show time under the format step as “<1” A non-zero time shorter than the smallest unit of the format is shown as <1m instead of 0m. Only on the panel. off
Show intervals An Intervals button on the issue panel expands the breakdown of the stopwatch - see Intervals off
Default Calendar, Calendar Select Field Working time used for counting; the Calendar Select field value on the issue overrides the default calendar Default 24x7, none
Weight (sort order) Lower weight panels appear first 100
Periodic update The panel refreshes itself every 60 seconds off

What the panel shows

The panel is laid out as a small table, like the Time in Status panel: labels on the left, times in one right-aligned column on the right. The first row is the state lozenge and the main value in bold; the extra values are lighter (grey) rows of the same table, slightly indented. The row under the mouse pointer is highlighted.

  • State lozenge: Inactive, Running (blue), Paused (yellow), Stopped.
  • Main value: the time spent.
  • Grey row: “Pause time:” when there was a pause. With the display mode Pause time it is the other way round: the pause time is the main value and the grey row is “Spent:”.

The panel auto-refreshes when Periodic update is enabled, so users see updated time without reloading the page.

Intervals

When Show intervals is on in the panel configuration (it is off by default, also for panels created before the option), an Intervals button below “Pause time:” expands the breakdown of the stopwatch - the same block as on the Timer panel, without the goal:

  • Calendar: the calendar applied (or 24/7);
  • each interval: Counted or Paused, its start and end (or “now”) in your time zone, and the counted time in a column on the right.

Up to 20 latest intervals are listed; “Earlier intervals not shown: N” counts the rest. A tooltip on a counted time shows the exact value when the format drops part of it. Intervals are cut separately, so they may not add up to the total exactly.


Preview

Next to the panel form, enter an issue key to see how the panel will look on that issue with the unsaved configuration: the state, the main value and the grey rows (“Pause time:” or “Spent:”) as the issue view shows them after you save, and the Intervals button when Show intervals is on. The key is remembered for this panel, including the key entered while the panel was created. The preview updates by itself half a second after a change.

If the panel will not show on that issue, the preview says The panel will not be visible on this issue and why: the issue’s project or issue type is outside the panel configuration, or the value is zero while Show zero value is off. The panel is still drawn below. The preview writes nothing.


When the panel does not show

Admin page > Health Check > Check an issue tells why a panel is or is not shown on an issue (see Health Check).


Tips

  • Independent from field settings: web panel event configuration is separate from the Stopwatch field setting. This lets you show a panel with different events than the custom field.
  • Periodic Update: enable this for panels that track active work, so the displayed time updates automatically.