Install the Plugin

Pre-flight Checklist

Run through this list first. It only takes a minute. However, each item saves a lot of time later.

• [ ] PHP 7.4 or higher (run php -v to check)
• [ ] WordPress 6.7 or higher
• [ ] WooCommerce 10.0 or higher, and active
• [ ] HPOS turned on at WooCommerce → Settings → Advanced → Features
• [ ] Site runs on HTTPS
• [ ] PHP has openssl, curl, and json extensions
• [ ] You have a Microsoft account with Azure AD rights
• [ ] You have a Power BI account (Pro if you want to embed reports)
• [ ] max_execution_time is at least 300 seconds for big stores

System Requirements

Here is the full version table, so you know what works.

You also need these three things:

1. WooCommerce must be installed and active before you turn on this plugin.
2. HPOS (High-Performance Order Storage) must be on. If not, some data will not sync.
3. HTTPS must be on. Microsoft will block OAuth on plain HTTP.

Your server also needs to reach these Microsoft URLs:

• https://login.microsoftonline.com
• https://api.powerbi.com
• https://graph.microsoft.com

How to Install the Plugin

You have three easy ways to install. Pick the one that fits your workflow.

Option 1 — Upload the ZIP (Easiest)

1. Grab woocommerce-power-bi-connector.zip from your Webkul account.
2. In WordPress, go to Plugins → Add New and click Upload Plugin.
3. Click Choose File, select the ZIP, and click Install Now.

Add Plugins — click Upload Plugin, choose the ZIP file, and click Install Now.

4. Wait for "Plugin installed successfully." and click Activate Plugin.

Installing woocommerce-power-bi-connector.zip — click Activate Plugin after installation completes.

Option 2 — FTP or SFTP

1. Unzip woocommerce-power-bi-connector.zip on your computer.

2. Open your FTP/SFTP client (FileZilla, Cyberduck, etc.) and connect to your server.

FileZilla — Local site (your computer) on the left, Remote site (your server) on the right.

3. On the remote side, navigate to /wp-content/plugins/. Then drag the unzipped woocommerce-power-bi-connector folder from the local side and drop it into the plugins directory.

Right-click the plugin folder on the left and select Upload — or drag it to the /wp-content/plugins/ folder on the right.

4. Open your WordPress admin panel and go to Plugins → Installed Plugins.

5. Search for WooCommerce Power BI Connector in the plugin list and click Activate.

Search "Power BI" — find WooCommerce Power BI Connector (Version 1.0.0 by Webkul) and click Activate.

Option 3 — WP-CLI (For Developers)

If you live in the terminal, run this one line:

wp plugin install /path/to/woocommerce-power-bi-connector.zip --activate

What Happens After You Activate

A few things happen right away. Here is what you will see.

First, a new menu called Power BI Connector shows up under Webkul WC Addons. It includes these pages:

• Dashboard
• Settings
• Setup Wizard
• Workspaces
• Datasets
• Tables
• Sync
• Export Center
• Data Load
• Reports
• Alerts
• Logs
• Access Control
• Query Builder

After activation, the Setup Wizard opens automatically.

Next, the Setup Wizard opens by itself. If it does not, just go to:

https://your-domain.com/wp-admin/admin.php?page=wkpbic-setup-wizard

Finally, the plugin creates a few database tables for logs, profiles, and the retry queue. It also gives only Administrators full access. You can change that later in Access Control.

Where to Go Next

You cannot use the plugin until you have your Microsoft keys. So finish these two pages next:

1. Azure AD Setup — get your Client ID, Secret, and Tenant ID.
2. Power BI Account Setup — get your workspace ready.

Then run the Setup Wizard to finish.

How to Uninstall or Reset

Sometimes you need to start over. Here is what each action does.

• Deactivate keeps all your data. Profiles, logs, and keys stay put.
• Uninstall (Delete from the Plugins screen) removes the files. By default, it keeps your settings in case you reinstall.
• Reset plugin (under Settings → Advanced) wipes everything — keys, profiles, logs — and starts fresh.