Manage Analytics views
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019
With Analytics views, you gain a simplified way to specify and share the filter criteria for a Power BI report based on Analytics data. Analytics provides the reporting platform for Azure DevOps.
Important
Analytics views only support Azure Boards data (work items). Analytics views don't support other data types, such as Pipelines. Views provide a flat-list of work items, and don't support work item hierarchies. At this point, we have no plans to update the connector to support other types of data. For information on other approaches, read Power BI Integration Overview.
Use this article to learn how to:
- Meet prerequisites to access Analytics views
- Open Analytics views
- Edit an existing view
- Share a view
- Favorite a view
- Manage permissions for a shared view
- Delete a view
Note
If Boards is disabled, then Analytics views will also be disabled and all widgets associated with work item tracking won't appear in the widget catalog and will become disabled. To re-enable a service, see Turn an Azure DevOps service on or off.
Prerequisites
- You must be a member of a project with Basic access or higher. If you don't have a project yet, create one. For more information, see Sign up for free.
- If you haven't been added as a project member, get added now. Anyone with access to the project, except stakeholders, can view Analytics views.
- Boards must be enabled. If it is disabled, Analytics views won't be displayed. To re-enable Boards, see Turn an Azure DevOps service on or off
- Enable the Analytics Views preview feature either for individual users or for the organization.
- Have the View Analytics permission set to Allow. For more information, see Grant permissions to access the Analytics service.
- You must be a member of a project with Basic access or higher. If you haven't been added as a project member, get added now. Anyone with access to the project, except Stakeholders, can view Analytics views.
- Verify that Analytics] is installed, and if not, then enable it. You must be an account owner or a member of the Project Collection Administrator group to add extensions or enable the service.
- Boards must be enabled. If it is disabled, Analytics views won't display. To re-enable Boards, see Turn an Azure DevOps service on or off.
- Have the View Analytics permission set to Allow. For more information, see Grant permissions to access the Analytics service.
Open Analytics to access views
A set of default Analytics views are defined for each project. You can view, modify, and create a custom view from Analytics.
If you don't see the team or team project you want, choose the 
Azure DevOps logo to browse all projects.
For Azure DevOps Server 2019.1
After you install or enable Analytics, a set of default Analytics views are created for each project. You can view, modify, and create a custom view from Analytics.
For Azure DevOps Server 2019
After you install the Analytics Marketplace extension, a set of default Analytics views are created for each project. You can view, modify, and create a custom view from Analytics.
From your web portal, expand Overview and choose Analytics views.
From your web portal, expand Boards and choose Analytics views.
If you don't see Analytics, check that it is enabled for the project collection and that you have permissions to view analytics. See the Prerequisites for this article.
Edit an existing view
The creator of a view and all members of the Project Administrators and Project Collection Administrators groups have permissions to edit, manage, and delete views.
From either the Favorites or All page, hover over the view you want to edit, select the
actions icon, and choose the Edit option. You can also choose Edit from the Summary panel.
You can edit any part of the view, in the same way you did to define a view. For details, see Create an Analytics view.
Save your changes.
Refresh your Power BI report to access the changes you made to the view.
Tip
If you remove fields from a view that are in use in the report, you'll need to update any Power BI report that references the view.
Share a view
All contributors to a project can view shared views and create Power BI reports based on them. When you create a view, you can choose to make it private or shared.
To share a private view, edit the view and change the sharing option to Shared. To unshare a view, switch the sharing option to Private.
Important
If you plan to share Power BI reports or dashboards based on an Analytics view, make sure the view is Shared. Otherwise, you are the only one who can modify the view and manually refresh the data. We recommend sharing views to support shared reports and dashboards.
Favorite a view
Favoriting an item provides a quick way to navigate to items you regularly visit.
To favorite a view, hover over the view and choose the 
.
Manage permissions for a shared view
All members of the Contributors group for your project can use Shared views in Power BI. For shared views that you create, you can manage the permissions of users and groups to create, delete, or view a specific shared view.
To change the permissions for a shared view, open Analytics views, and choose All. For details, see Create an Analytics view.
Choose the
More Actions icon and then choose Security.Change the permissions so that the team member or group can't edit or delete the view.
Add a user or group who you want to grant permissions to or restrict access.
Close the dialog when done. Your changes are automatically saved.
Choose Save changes when done.
Delete a view
You can always delete a view you created. Once you delete a view, any Power BI report or dashboard that depends on the view will no longer refresh.
To delete a view, select the
actions icon and choose 
Delete from the menu.