YouTrack Cloud 2024.3 Help

Agile Board Status Widgets

An Agile Board Status widget displays the state of issues on an agile board as a bar chart on your dashboard.

To add an Agile Board Status 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 Agile Board Status.

    • The configuration dialog for the new widget opens.

  5. Select an agile board.

  6. If the agile board is configured for sprints, select a sprint.

    • Select Always displays current sprint for the widget to display the newest sprint of the selected agile board.

  7. Agile Board Status widget settings
  8. Click the Save button.

The Agile Board Status widget is added to the dashboard.

Working with an Agile Board Status Widget

When you add an Agile Board Status widget to your dashboard, it displays a bar chart showing the number of issues based on each issue's state value.

The owner of the agile board is displayed at the top of the widget.

  • Mouse over bars in the widget to view the number of issues with each state value.

  • Click a status bar in the widget to open the Issues List displaying the issues with that state value.

Agile Board Status 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

You can manually refresh the widget by clicking the refresh icon in the title bar.

Agile Status Board Widget Use Case

View the Progress of Your Current Sprint

You're a YouTrack project owner and want to have a fast way to know your team's progress in the current sprint. Use the Agile Board Status widget to display a bar chart on a dashboard showing the progress of the sprint.

Configure the widget by selecting an agile board from your project.

You now have a widget on your dashboard displaying how many issues from your agile board are in which state. You can use this knowledge to help focus your resources on finishing the maximum number of issues during your sprint.

Last modified: 14 January 2025