Hub 2023.2 Help

Custom Widgets

You can build your own custom widgets and add them to your dashboards. Extend the functionality of your dashboards to grab content from external sources or present data from connected services in a unique format. Support for this feature has also been added to the new Project Overview page.

If you're not quite confident in your own ability to create a custom widget, you can access widgets built by other users that have been uploaded to JetBrains Marketplace. You might find exactly the widget you're looking for without having to build it yourself.

This section of the documentation describes how to manage available widgets on the Custom Widgets page of your Hub installation. If you want to learn more about building widgets, see https://www.jetbrains.com/help/youtrack/devportal/2021.1/building-custom-widgets.html.

Custom widgets help you create a consolidated overview of the information that is important to your team. For example:

  • Your Quality Assurance team uses dedicated software for testing. You can build a custom widget that displays a list of failing tests.

  • Your Customer Support Engineers use dedicated software for managing support requests. You can build a custom widget that displays the number of unanswered requests.

For more examples, see https://www.jetbrains.com/help/youtrack/devportal/2021.1/sample-custom-widgets.html.

Manage the status of each widget in a central location on the Custom Widgets page. We've even built a playground where you can preview and test your widgets.

Widgets in Hub

Hub widgets are built to show information on dashboards and project overview pages. These widgets can pull information from external sources or connected services. They can potentially display data from Hub, TeamCity, and YouTrack.

TeamCity itself does not have a platform for displaying widgets. However, it is possible to build custom widgets that display information from a TeamCity server. Like the TeamCity Widgets that are built into Hub, these widgets can be installed on Hub dashboards and project overview pages only when TeamCity is connected as a service in Hub.

A widget that displays data from TeamCity is only compatible with an external Hub installation.

Widgets in YouTrack

For YouTrack Server installations that use a built-in Hub service and YouTrack Cloud, the Hub service is fully integrated into YouTrack. The link to the Dashboards page is always shown in the application header.

  • If your Hub service is built into YouTrack, you can access your dashboards without leaving the application.

  • If your YouTrack installation is connected to an external Hub service, the Dashboards link navigates directly to the Hub service.

For YouTrack installations that use a built-in Hub service, these dashboards can display widgets that are compatible with both Hub and YouTrack.

Widget Availability

With custom widgets that display data from a service that is connected to Hub, users who don't have read access to the service won't see any data in the widget. The following factors determine whether users have access to the data that is displayed in a widget:

  • The user is a member of a group for which the service is visible. This collection of groups is stored in the Access setting for the connected service. For more information, see Settings.

  • The user is granted a role that includes the Low-level Admin Read permission. This is a global permission that is included in the default System Admin role. If you or another administrator customize the permission scheme, this permission may added to other roles. For more information, see Hub Permissions.

Last modified: 05 December 2023