Power BI admin portal

The admin portal allows for tenant management of Power BI in your organization. It includes items such as usage metrics, access to the Office 365 admin center, and settings.

Tenant management of Power BI for your company is done through the Power BI admin portal. The admin portal is accessible to all users who are Global Admins in Office 365 or have been assigned the Power BI service administrator role. For more information about the Power BI service administrator role, see Understanding the Power BI admin role.

All users will see Admin portal under the gear icon. If they are not an admin, they will only see the Premium settings section, and they will only see the capacities they have rights to manage.

How to get to the admin portal

Your account needs to be marked as a Global Admin, within Office 365 or Azure Active Directory, or have been assigned the Power BI service administrator role, to get access to the Power BI admin portal. For more information about the Power BI service administrator role, see Understanding the Power BI admin role. To get to the Power BI admin portal, do the following.

  1. Select the settings gear in the top right of the Power BI service.
  2. Select Admin Portal.

Within the portal, there are six tabs. These are described below.

Usage metrics

The first tab, in the admin portal, is Usage metrics. The usage metrics report gives you the ability to monitor usage within Power BI for your organization. It also provides the ability to see which users, and groups, are the most active within Power BI for your organization.

Note

The first time you access the dashboard, or after you visit again after a long period of not viewing the dashboard, you'll likely see a loading screen while we load the dashboard.

Once the dashboard loads, you will see two sections of tiles. The first section includes usage data for individual users and the second section has similar information for groups in your organization.

Here’s a breakdown of what you will see in each tile:

  • Distinct count of all dashboards, reports, and datasets in the user workspace

  • Most consumed dashboard by number of users who can access it. For example, if you have a dashboard that you shared with 3 users, and you also added it to a content pack two different users connected to, its count would be 6 (1 + 3 + 2)

  • The most popular content users connected to. This would be anything the users could reach through the Get Data process, so SaaS content packs, Organizational content packs, files or databases.

  • A view of your top users based on how many dashboards they have, both dashboards they created themselves and dashboards shared to them.

  • A view of your top users based on how many reports they have

The second section shows the same type of information, but based on groups. This will let you see which groups in your organization are most active and what kind of information they are using.

With this information, you will be able to get real insights into how people are using Power BI across your organization, and be able to recognize those users, and groups, who are very active in your organization.

Users

The second tab, in the admin portal, is Manage Users. User management, for Power BI, is done in the Office 365 admin center, so this section allows you to quickly reach the area to manage users, admins, and groups within Office 365.

When you click Go to O365 Admin Center, you go directly to the Office 365 admin center landing page, to manage the users of your tenant.

Audit logs

The third tab, in the admin portal, is Audit logs. The logs are located within the Office 365 Security & Compliance center. This section allows you to quickly access that area within Office 365.

For more information about audit logs, see Auditing Power BI in your organization

Tenant settings

The third tab, in the admin portal, is Tenant settings. Tenant settings give you more control over what features are made available to your organization. If you have concerns around sensitive data, some of our features may not be right for your organization, or you may only want a given feature to be available to a specific group. If this is the case, you can switch it off in your tenant.

Note

It can take up to 10 minutes for the setting to take effect for everyone in your tenant.

Settings can have three states based on the settings that you supplied.

Disabled for the entire organization

You can disable a feature and make it so users will not be able to use it.

Enabled for the entire organization

You can enable a feature for the entire organization which will let all users have access to that feature.

Enabled for a subset of the organization

You can also enable a feature for a portion of your organization. This can happen in a few different ways. You can enable it for your entire organization except for a specific group of users.

You could also enable the feature only for a specific group of users and also disable it for a group of users. This would make sure that certain users do not have access to the feature even if they are in the allowed group.

Export and sharing settings

Share content to external users

Users in the organization can share dashboards with users outside the organization.

Here is the message that will appear when you share with an external user.

Publish to web

Users in the organization can publish reports to the web. Learn more

Users will see different options in the UI based on what the publish to web setting is.

Feature Enabled for entire organization Disabled for entire organization Specific security groups
Publish to web under report's File menu. Enabled for all Not visable for all Only visable for authorized users or groups.
Manage embed codes under Settings Enabled for all Enabled for all Enabled for all

* Delete option only for authorized users or groups.
* Get codes enabled for all.
Embed codes within admin portal Status will reflect one of the following:
* Active
* Not supported
* Blocked
Status will display Disabled Status will reflect one of the following:
* Active
* Not supported
* Blocked

If a user is not authorized based on the tenant setting, status will display as infringed.
Existing published reports All enabled All disabled Reports continue to render for all.

Export data

Users in the organization can export data from a tile or visualization. Learn more

Note

Disabling Export Data will also prevent users from using the Analyze in Excel feature, as well as using the Power BI service live connection.

Export reports as PowerPoint presentations

Users in the organization can export Power BI reports as PowerPoint files. Learn more

Users in the organization can print dashboards and reports. Learn more

Content pack settings

Publish content packs to the entire organization

Users in the organization can publish content packs to the entire organization.

Create template organizational content packs

Users in the organization can create template content packs that use datasets built on one data source in Power BI Desktop.

Push apps to end users

Your tenant admin enables the ability to push apps in Tenant settings.

Enable pushing apps

You can switch the setting to Enabled and then specify who gets this capability (entire org or specific security groups).

Note

Remember that tenant setting changes can take some time to take effect.

Go here to learn more about Push apps.

Integration settings

Ask questions about data using Cortana

Users in the organization can ask questions about their data using Cortana.

Note

This settings applies to the entire organization and cannot be limited to specific groups.

Use Analyze in Excel with on-premises datasets

Users in the organization can use Excel to view and interact with on-premises Power BI datasets. Learn more

Note

Disabling Export Data will also prevent users from using the Analyze in Excel feature.

User ArcGIS Maps for Power BI (Preview)

Users in the organization can use the ArcGIS Maps for Power BI (Preview) visualization provided by Esri. Learn more

Custom visuals settings

Enable custom visuals for the entire organization

Users in the organization can interact with and share custom visuals. Learn more

Custom visuals settings

Note

This setting applies to the entire organization and cannot be limited to specific groups.

R visuals settings

Interact with an dshare R visuals

Users in the organization can interact with and share visuals created with R scripts. Learn more

Note

This settings applies to the entire organization and cannot be limited to specific groups.

Audit settings

Create audit logs for internal activity auditing and compliance

Users in the organization can use auditing to monitor actions taken in Power BI by other users in the organization. Learn more

This setting needs to be enabled for audit log entries to be recorded.

Note

This settings applies to the entire organization and cannot be limited to specific groups.

Dashboard settings

Data classification for dashboards

Users in the organization can tag dashboards with classifications indicating dashboard security levels. Learn more

Note

This settings applies to the entire organization and cannot be limited to specific groups.

Developer settings

Embed content in apps

Users in the organization can embed Power BI dashboards and reports in Software as a Service (SaaS) applications. Disabling this setting will prevent users from being able to use the REST APIs to embed Power BI content within their application.

Premium settings

The Premium settings tab allows you to manage any Power BI Premium capacity that has been purchased for your organization. All users within your organization will see the Premium settings tab, but will only see contents within it, if they are assigned as either Capacity admin or a user that has assignment permissions. If a user does not have any permissions, they will see the following message.

For more information about to manage Premium settings, see Manage Power BI Premium.

Embed codes

Embed codes within the Power BI admin portal

As an administrator, you can view the embed codes that are generated for your tenant. You have the actions of viewing the report and deleting the embed code to revoke it.

Organization visuals

The organization visuals tab enables you to deploy and manage custom visuals inside your organization, so you can easily deploy proprietary custom visuals in the organization, for report authors to easily discover and import those visuals directly from Power BI Desktop into their reports.

The page shows all the custom visuals that are currently deployed in the organization repository.

Add a new custom visual

To add a new custom visual to the list, select Add a custom visual

Warning

A custom visual could contain code with security or privacy risks; make sure you trust the author and the source of the custom visual before deploying to the origination repository.

Fill in the fields:

  • Choose a .pbiviz file (required): select a custom visual file to upload. Only versioned API custom visuals are supported (read here what this means). Before you upload a custom visual, you should review that visual for security and privacy to make sure it fits your organization's standards. Read more about custom visuals security.

  • Name your custom visuals (required): give a short title to the visual so Power BI Desktop users easily understand what it does

  • Icon (required): The icon file that will be shown in the Power BI Desktop UI.

  • Description: a short description of the visual to provide more context and education to the user

Select "Apply" to initiate the upload request. If successful you will see the new item in the list. If failed, you will get an appropriate error message

Delete a custom visual from the list

Select the trash bin icon to permanently delete the visual from the repository. Important: deletion is irreversible. Once deleted, the visual will immediately stop rendering in existing reports. Even if you upload the same visual again, it will not replace the previous one that was deleted, users will have to import the new visual again and replace the instance they have in their reports.

How to update a visual

If you'd like to update a visual in the repository because there is a new version of the visual (e.g. bug fixes, new functionality, etc.), select the Update icon, and upload the new file. Make sure the Visual ID remains unchanged. The new file will replace the previous file for all the reports throughout the organization. However, if the new version of the visual might break any usage or data structure of the previous version of the visual, then do not replace the previous version. Instead, you should create a new listing for the new version of the visual. For example, add a new version number (version X.X) to the title of the new listed visual. This way it is clear that it is the same visual just with an updated version number, so existing reports do not break their functionality. Again, make sure the Visual ID remains unchanged. Then the next time users enter the organization repository from Power BI Desktop, they can import the new version, which will prompt them to replace the current version that they have in the report.

Next steps

Understanding the Power BI admin role
Auditing Power BI in your organization
Manage Power BI Premium
Administering Power BI in your Organization

More questions? Try asking the Power BI Community