> ## 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.

> ## Agent Instructions
> These docs contain multiple Speckle product experiences. For Speckle 2026.9, prefer /next/ pages for the topics and changes they cover. The navigation label Current does not override this version-specific precedence.
> Coverage under /next/ is incremental. Use Current documentation for unchanged topics and when a /next/ page says coverage is unavailable or explicitly refers you to Current. Do not infer a feature was removed from a missing page.
> Read the page-specific documentation status, applicability, affected guidance and replacement links in agent-only content. Impacted, changed and superseded apply only to the stated scope; they do not mean the entire feature is deprecated. Historical connector guides apply only to the legacy connector described.
> Match guidance to the customer's deployment version, model data format and connector. Respect plan, permission and compatibility restrictions. If an unknown version or data format changes the answer, ask a focused clarification; do not infer deployment version from the date alone.

# Bentley ProjectWise

> Connect Bentley ProjectWise Cloud or an on-premises ProjectWise WSG server to Speckle for automatic model synchronization.

<Badge>Alpha</Badge>

<Info>
  The Bentley ProjectWise integration is available on the **Enterprise** plan. To use it on another
  plan, [talk to
  sales](mailto:sales@speckle.systems?subject=Bentley%20ProjectWise%20Integration%20enquiry).
</Info>

## Choose a connection

Speckle can connect to ProjectWise in two ways. Choose the option that matches where your ProjectWise data is hosted and how users authenticate.

| Connection | Use it for | Authentication | IT preparation |
| - | - | - | - |
| **Cloud** | Bentley Infrastructure Cloud projects | Bentley account through IMS | Add the Speckle service account to each project |
| **On-Prem** | ProjectWise servers exposed through WSG | ProjectWise Native Authentication with a username and password | Make WSG reachable from Speckle and enable Native Authentication |

Your IT administrator should complete the relevant steps in [Configure Bentley ProjectWise Integration](/it-admin/integrations/projectwise) before users connect.

## Connect to ProjectWise

<Tabs>
  <Tab title="Cloud">
    Use this option for Bentley Infrastructure Cloud. Speckle uses your Bentley account to show the projects and work areas you can access.

    <Steps>
      <Step title="Open the ProjectWise integration">
        1. Open a Speckle project.
        2. In the project sidebar, expand **Integrations** and select **ProjectWise**.
        3. Select **Connect to ProjectWise**.
      </Step>

      <Step title="Sign in with Bentley">
        1. Sign in to your Bentley account.
        2. Select **Allow** in the Bentley authorization dialog.
      </Step>

      <Step title="Choose and sync a file">
        1. Select an iTwin project.
        2. Browse the available **Share** folders or **ProjectWise Web** work areas.
        3. Select one or more supported files.
        4. Review the file settings, then select **Create**.

        Speckle creates a model for each selected file and starts the first sync.
      </Step>
    </Steps>
  </Tab>

  <Tab title="On-Prem">
    Use this option to connect directly to an on-premises ProjectWise WSG server. You do not need to sign in with a Bentley cloud account.

    Before starting, obtain the WSG base URL and ProjectWise credentials from your IT administrator. The server must support WSG v2.9 and Native Authentication.

    <Steps>
      <Step title="Open the ProjectWise integration">
        1. Open a Speckle project.
        2. In the project sidebar, expand **Integrations** and select **ProjectWise**.
        3. Select **Add datasource**.

        If ProjectWise Cloud is already connected, use **Add datasource** in the connection bar instead.
      </Step>

      <Step title="Connect a datasource">
        1. Enter the WSG base URL, such as `https://projectwise.example.com`.
        2. Select **Get datasources**.
        3. Choose the datasource you want to connect.
        4. Enter your ProjectWise username and password.
        5. Select **Test & Connect**.

        Enter the server base URL only. Do not add `/WS/v2.9/Repositories` to the URL.
      </Step>

      <Step title="Choose and sync a file">
        1. Select the datasource tab.
        2. Browse its work areas and folders.
        3. Select one or more supported files.
        4. Review the file settings, then select **Create**.

        Speckle creates a model for each selected file and starts the first sync.
      </Step>
    </Steps>

    <Note>
      Speckle encrypts your ProjectWise credentials before storing them. They enable server-side file downloads and background synchronization.
    </Note>
  </Tab>
</Tabs>

## Supported file formats

In default 2026.9 mode, cloud sync supports the same file formats as file uploads. For available
formats and compatibility-mode restrictions, see
[Supported formats by upload mode](/next/connectors/file-uploads#supported-formats-by-upload-mode).

<Info>
  Navisworks support can vary between files. If an NWD or NWC sync fails, [tell
  us](mailto:office@speckle.systems).
</Info>

## FAQs and troubleshooting

<AccordionGroup>
  <Accordion title="Is the connection read-only?">
    Yes. Speckle downloads and converts source files but does not change files or folders in ProjectWise. The converted data is stored as versioned objects in the Speckle project.
  </Accordion>

  <Accordion title="How quickly are file changes synced?">
    Speckle checks ProjectWise on a schedule, so a change may take a few minutes to appear. When a change is detected, Speckle creates a new model version from the file version current at that check. Versions superseded between checks, or whose sync fails, are not synced later; see [Sync guarantees](/it-admin/integrations/introduction#sync-guarantees).
  </Accordion>

  <Accordion title="How do I manage an on-premises connection?">
    Each connected datasource appears as a tab. Use the settings icon next to its name to change the server, datasource, username, or password.

    Saved connections are personal to your Speckle user in that workspace. Other workspace members connect the datasource with their own ProjectWise credentials.

    Leave the username and password blank when editing a connection to keep the stored credentials. Enter both fields to replace them.
  </Accordion>

  <Accordion title="What happens if I disconnect a datasource?">
    Disconnecting a datasource deletes its saved credentials. Existing syncs that use them cannot update; connect again and recreate those syncs if needed.
  </Accordion>

  <Accordion title="What happens if my stored credentials stop working?">
    Speckle immediately pauses every sync using that connection and emails the connection owner. This prevents repeated attempts from locking the ProjectWise account.
  </Accordion>

  <Accordion title="What does the ProjectWise integration support?">
    The integration supports model and file synchronization. It does not provide general ProjectWise document management.
  </Accordion>

  <Accordion title="Speckle cannot reach my WSG server">
    Confirm that you entered the WSG base URL and that Speckle Cloud can resolve and reach it over HTTPS.

    Ask your IT administrator to check DNS, firewall rules, the TLS certificate, and the `/WS/v2.9/Repositories` endpoint.
  </Accordion>

  <Accordion title="No datasources were found">
    Confirm that the URL points to the WSG server, not a ProjectWise Web page. The server must return its repositories from `/WS/v2.9/Repositories`.
  </Accordion>

  <Accordion title="The server does not support Basic Auth login">
    Ask your ProjectWise administrator to enable **Native Authentication** for WSG. Bentley IMS authentication is used by the Cloud connection and cannot replace Native Authentication for this On-Prem connection.
  </Accordion>

  <Accordion title="My password changed and the sync was paused">
    Open the datasource settings, enter the new username and password, and save the connection. Then open each affected sync and select **Resume**.
  </Accordion>

  <Accordion title="A synced file was moved or deleted">
    Speckle pauses the sync after the file is missing for three checks. Restore it to its original location or create a new sync from the file's new location.
  </Accordion>

  <Accordion title="My cloud projects or files are missing">
    Confirm that your Bentley account can access the project. Also confirm that the Speckle service account has been added to the relevant Bentley project.
  </Accordion>

  <Accordion title="Can I use ProjectWise models with Speckle Intelligence?">
    Yes. After a model is synced, it can be used with Speckle Intelligence, dashboards, automations, and other Speckle workflows.
  </Accordion>
</AccordionGroup>

## Getting help

For setup help or Alpha feedback, contact our support team or visit the [Speckle Community](https://speckle.community/).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.