YouTrack Server 2024.3 Help

Issue List Widgets

An Issue List widget displays a list of issues that match a search query, saved search, project, or tag.

To add an Issue List 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 Issue List.

    • The configuration dialog for the new widget opens.

  5. Enter an optional widget title.

  6. Configure the widget by performing a combination of the following actions:

    • Select a search context from the drop-down list.

    • Enter a search query in the input field.

    • Select a saved search on the Saved Search tab.

    • Select a project on the Projects tab.

    • Select a tag on the Tag tab.

    Issue List widget settings
  7. Click the Save button.

    • The Issue List widget is added to the Dashboard.

    • If you didn't specify a title, the title of the widget is set to the selected search query, saved search, project, or tag.

    Issue List widget saved

When you click the title of the widget, YouTrack displays the issue list with the results of the search query configured for the widget.

Working with an Issue List Widget

When you add an Issue List widget to your dashboard, you can interact with it in the following ways:

Interactive elements in an issue list widget.
  1. Click the widget title to open the corresponding query in the Issues list.

  2. Click a summary to open the corresponding issue.

  3. Click to refresh the widget.

  4. Click to expand and view the values for custom fields in the corresponding issue. Only values for custom fields are shown in this view. Standard fields like Project and Boards aren't visible. Additional information like tags, descriptions, and comments aren't visible.

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 Widgets Data

The widget content is refreshed every 10 minutes by default. To manually refresh an issue widget, click the refresh icon in the title bar.

Learn more about setting up refresh rates for individual widgets.

Issue List Widget Use Cases

Your Issues

You're a YouTrack user and want to be aware of all the issues that are assigned to you and unresolved for specific projects. Use the Issue List widget to display a list of all your unresolved issues for those projects on your dashboard.

Set this widget up by configuring the search context with the name of your project. In the search query field, enter Assignee: me and State: Unresolved.

Issue List widget example configuration

All of the issues assigned to you that are not yet in a resolved state are now located in a convenient list on your dashboard.

Issue List widget example

Blocked Issues

You're a Youtrack project owner and want to make sure that your project issues are being completed as you expect. Sometimes team members run into problems completing issues because the issue state is Blocked. Use the Issue List widget on a dashboard to stay informed if you have blocked issues in your project.

Set this widget up by configuring search context with the name of your project and the search query to State: Blocked.

Blocked issue use case
Last modified: 11 December 2024