Skip to main content
This guide is for IT administrators only. If you are a regular user, see our Power BI installation guide instead.
Certificate configuration required: Power BI requires you to register Speckle’s security certificate before the connector will work. Follow the registry steps carefully.
All current Speckle Connectors require the Speckle Desktop Services background service. Learn more about Desktop Services.

​
Install for a single user

  1. Extract the downloaded ZIP file.
  2. Copy the .pqx file to %UserProfile%\Power BI Desktop\Custom Connectors\
    • Create the directory if it doesn’t exist
  3. Copy the .pbiviz file to %UserProfile%\Power BI Desktop\Custom Visuals\
    • Create the directory if it doesn’t exist

​
Register the security certificate

Power BI must trust Speckle’s certificate before the connector can load. This step requires administrator access.
  1. Open Registry Editor (press Windows key + R, type regedit, and press Enter).
  2. Navigate to HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Power BI Desktop
  3. Create a new value named TrustedCertificateThumbprints with type REG_MULTI_SZ (if it doesn’t already exist).
  4. Add the following certificate thumbprints to this value:
    • For Speckle v3.2.2 and earlier: 5270B3C69218C25BE2F20AB2DD76429DDAA38F61
    • For Speckle v3.2.3 and later: CDC489B709A709E3283568A9B75D75180B1355BE
    Add both thumbprints: We recommend adding both certificate thumbprints to ensure compatibility with all versions. If other thumbprints already exist, add the Speckle thumbprints as new lines.
This registry configuration removes the need to manually enable “Allow any extension to load without validation or warning” in Power BI’s security settings. Learn more about trusted third-party connectors in Power BI.

​
Disable update notifications

To prevent update checks, contact [email protected] for a file to replace the connector configuration database.

​
Uninstall the connector

  1. Delete the .pqx file from %UserProfile%\Power BI Desktop\Custom Connectors\
  2. Delete the .pbiviz file from %UserProfile%\Power BI Desktop\Custom Visuals\
  3. Optionally, remove the Speckle certificate thumbprints from the registry.
To remove all Speckle products, delete the %AppData%\Speckle\ folder.

Back to manual installation overview

Return to connector selection