Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt

Use this file to discover all available pages before exploring further.

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.
Connector versions < 3.5.0 require the Speckle Desktop Services background service. Learn more about Desktop Services. For versions ≥ 3.5.0; the desktop service is not required.

​
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 trusted certificate

Power BI must trust Speckle’s certificate before the connector can load. This step requires administrator access.
  1. If it doesn’t already exist, create a new registry value named TrustedCertificateThumbprints with type REG_MULTI_SZ in HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Power BI Desktop
  2. To the value data, add the following certificate thumbprints (each thumbprint on a new line)
    • For Speckle v3.2.3 and later: CDC489B709A709E3283568A9B75D75180B1355BE
    • For Speckle v3.2.2 and earlier: 5270B3C69218C25BE2F20AB2DD76429DDAA38F61
    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.

​
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, also delete the %AppData%\Speckle\ folder.

Back to manual installation overview

Return to connector selection
Last modified on April 30, 2026