- Overview
- Where it shows
- Creating a web panel
- Settings reference
- What the panel shows
- Preview
- When the panel does not show
- Tips
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
- Open the admin panel > Stopwatch tab > Web Panels
- Click Create
- Configure the panel on the tabs of the form (see reference below) and check it in the Preview
- 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.

