Set up your environment for developing a Power BI visual

In this article, you'll learn how to set up your environment for developing a Power BI visual.

Before you start development, you'll need to install node.js and the pbiviz package. Then, when your local environment is set up, you'll need to configure Power BI service for developing a Power BI visual.

In this article, you'll learn how to:

Install node.js

Node.js is a JavaScript runtime built on Chrome's V8 JavaScript engine. It allows developers to run any apps created on JavaScript.

To install node.js:

  1. In a web browser, navigate to node.js.

  2. Download the latest recommended MSI installer.

  3. Run the installer, and then follow the installation steps. Accept the terms of the license agreement and all defaults.

  4. Restart your computer.

Install pbiviz

The pbiviz tool, which is written using JavaScript, compiles the visual source code of the pbiviz package.

The pbiviz package is a zipped Power BI visual project, with all the needed scripts and assets.

To install the latest version of pbiviz, open Windows PowerShell and enter the following command.

npm i -g powerbi-visuals-tools@latest


You might get some warnings when you run this command. They should not prevent pbiviz from installing.

(Optional) Verify that your environment is set up

Confirm that the Power BI visuals tools package is installed. In PowerShell, run the command pbiviz and review the output, including the list of supported commands.

Screenshot of the output of executing the command p b i viz in PowerShell.

Set up Power BI service for developing a visual

To develop a Power BI visual, you'll need to enable custom visual debugging in Power BI service. Follow the instructions in this section to enable this option.

  1. Sign in to

  2. Navigate to Settings > Settings > Settings.

    Screenshot of the settings, settings, settings, menu option in Power B I service.

  3. From the General tab, select Developer. In the Developer setting, select the Enable developer mode check box, and then select Apply.

    Screenshot of the enable developer mode, in the Power BI settings, general tab.

Next steps