YouTrack Server 2024.3 Help

Time Tracking Report Widgets

A Time Tracking Report widget displays either a Time Report or a Timesheet Report on your dashboard.

Use this widget to monitor how you or your team spend time working on issues in YouTrack.

To add a new Time Tracking Report widget to a dashboard:

  1. Click Dashboards in the main navigation menu.

  2. Select a dashboard for the widget.

  3. Click the Add widget button on the dashboard.

  4. From the drop-down list, select Time Tracking Report.

    • The configuration dialog for the new widget opens.

    New time tracking report widget settings
  5. Select the Create new report tab.

  6. Enter a name for the report.

  7. Open the X axis drop-down menu:

    • Select Time to create a Timesheet Report.

      • Select Day, Week, or Month for the X axis column names.

    • Select Work types to create a Time Report.

  8. Optionally, create a filter for issues to include in the distribution list with a query.

  9. Select one or more projects.

  10. Select one or more users for the report.

  11. Select one or more Work types for the report.

  12. Select a time period the report covers.

    • Select Fixed to enter a custom date interval.

  13. Optionally, select a custom field to group the Y axis of the chart.

  14. Sharing settings:

    • Select which users and groups can view and use this widget on their dashboard.

    • Select which users and groups can edit the settings of the widget.

You can also use existing Time Reports or Timesheet Reports in this widget.

To add a widget with an existing Time Report or Timesheet Report to a dashboard:

  1. Click Dashboards in the main navigation menu.

  2. Select a dashboard for the widget.

  3. Click the Add widget button on the dashboard.

  4. From the drop-down list, select Time Tracking Report.

    • The configuration dialog for the new widget opens.

    Existing distribution report widget settings
  5. Select the Display existing report tab.

    • Select an existing report from the drop-down menu.

    • The configuration dialog is auto-completed based on the selected report.

  6. Optionally, make edits to the existing report.

  7. Click Save to save the changes to the report and add the widget to the dashboard.

Working with a Time Tracking Report Widget

When you add a Time Tracking Report widget to your dashboard, a Time Report or a Timesheet Report is displayed.

  • A Time Report shows the total amount of time spent working on issues in one or more projects. It displays the type of work done and the original estimation. Time spent can be grouped by a number of values including work type, work author, parent issue, and issue type.

    Time Report Widget
  • A Timesheet Report shows how users allocated spent time for a collection of issues in a calendar-based spreadsheet. You can show totals per user or per issue on a daily, weekly, or monthly basis.

    Timesheet Report Widget

Click the More menu in the corner of the widget to expand a list of available actions.

Action

Description

Share link

Opens a dialog with a link that can be copied and shared with teammates.

  • When a user pastes this link into the address bar in their web browser, the shared widget is added to their current dashboard. This can either be the dashboard that they're currently viewing in YouTrack or the dashboard that they most recently accessed.

  • If the person with whom you shared the widget doesn't have permission to view the data that is used in the widget, the widget is empty.

Clone widget

Creates a duplicate of the widget on your dashboard.

Move to another dashboard...

Opens a dialog with a drop-down menu of available dashboards. Select a new dashboard for the widget and click Move. The widget is removed from the current dashboard and moves to the selected dashboard.

Edit...

Modify the settings of the widget.

Remove

Opens a dialog. Click Delete to permanently remove the widget.

About

Opens a new YouTrack page in the web browser to the details section of the widget in Apps.

Refreshing Widget Data

The widget content is refreshed according to the custom refresh rate, when set. Otherwise, the widget is refreshed every 4 minutes.

To manually recalculate a report in a widget, click the refresh icon in the title bar.

Time Tracking Report Widget Example

You're a project owner and want to see the amount of time that group members spend on the issue Work types Development and Testing each week. Use the Time Tracking Report widget to display that information on your dashboard.

To create a time tracking report widget to display user time spent per work type:

  1. Click Dashboards in the main navigation menu.

  2. Select a dashboard for the widget.

  3. Click the Add widget button on the dashboard.

  4. From the drop-down list, select Time Tracking Report.

    • The configuration dialog for the new widget opens.

  5. Enter a name for the widget describing the time tracking report you're creating.

  6. Select Time and Week for the X axis field.

  7. Select all the projects you want to add the Timesheet report.

  8. Select all the users you want to add to the Timesheet report.

    • This example selects all users of the project.

  9. Select the work types you want to add to the Timesheet report.

    • This example selects the work types Development and Testing.

  10. Select the time period for the Timesheet report.

    • This example selects This month to display a time sheet for the current month.

  11. Select to group by the Work type to see how much time members spent on the above selected work types.

  12. By default, you're the only user able to view or edit the widget. Update the sharing settings if you want other users to view or edit the widget.

    Time Tracking Report widget example settings
  13. Click Save.

The widget is displayed on your dashboard with a Timesheet report. This report shows the amount of time the selected users spent per week on the selected issue work types.

Time Tracking Report widget example

You can also switch the Y axis from Users to Issues so the widget displays a timesheet showing how much time was spent on each issue by work type.

Time Tracking Report widget example
Last modified: 19 November 2024