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

# How to use Speckle for Navisworks

> Step-by-step guide for using the Navisworks connector

export const app_3 = "Navisworks"

export const app_2 = "Navisworks"

export const app_1 = "Navisworks"

export const app_0 = "Navisworks"

export const versions_0 = "2020, 2021, 2022, 2023, 2024, 2025, 2026, & 2027"

export const os_0 = "Windows"

Documentation status: impacted for the changes in Speckle 2026.9 (from 2026-09).

Affected guidance: 2026.8 is the last desktop installer and remains advised around 200 MB; larger files use upload.

For these changes, read [2026.9 guidance](/next/connectors/navisworks/introduction).

For Speckle 2026.9, prefer the linked guidance only for the affected topics. This page remains applicable to earlier experiences and unchanged guidance. Do not treat the whole page or feature as deprecated.

<Info>
  Speckle currently supports {app_0} versions: **{versions_0}**. The {app_0} connector works on **{os_0}**
  only.
</Info>

<Warning>
  **2026.8 is the last Navisworks desktop connector.** There is no 2026.9 installer. A publish
  around **200 MB** still uses this connector. For larger files, upload an NWC or NWD. See
  [Navisworks in 2026.9](/next/connectors/navisworks/introduction).
</Warning>

## Setup

<Steps>
  <Step title="Install the connector">Install your [{app_1} connector](/connectors/installation)</Step>

  <Step title="Open the Navisworks connector">
    1. In Navisworks, select the **Speckle** tab in the ribbon.

    <Frame>
      <img src="https://mintcdn.com/speckle/5UIlyL-HMgYLn0Bd/images/connectors/navisworks_toolbar.jpg?fit=max&auto=format&n=5UIlyL-HMgYLn0Bd&q=85&s=e5bc9d88d92239455d67ec3c7d56abba" alt="Navisworks toolbar" width="2592" height="1728" data-path="images/connectors/navisworks_toolbar.jpg" />
    </Frame>

    2. Select **Speckle** to open the Navisworks connector.

    3) Select **Sign in** if you haven't linked your Speckle account.
           <Frame>
             <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/connectors/dui_login.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=86fa2dc39cdfb61ed5472ba570e40b87" alt="Login" width="1296" height="864" data-path="images/connectors/dui_login.jpg" />
           </Frame>
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Why is the Speckle plugin not showing up after I installed the connector?">
    1. Make sure your version of {app_2} is one of the supported versions.
    2. Uninstall and [reinstall your connector](/connectors/installation).

    <Note>
      Don't select **Run as administrator** when installing: that installs the connector for the
      administrator account, not yours. Double-click the `.exe`, or right-click it and select **Open**.
    </Note>

    Installation issues can also be caused by conflicting plugins.

    If you're still experiencing problems, report it in our [Community Forum](https://speckle.community/c/help) and include:

    * Your application version
    * Your Speckle connector version
  </Accordion>

  <Accordion title="What should I do if the plugin UI is empty or unresponsive, or if my application crashes?">
    If your connector window is floating, **try docking it to your application** to fix blank UI
    issues. For major issues, you can sometimes find a `log` file in your directory at
    `AppData\Roaming\Speckle\Logs`. Report your problem in our [Community
    Forum](https://speckle.community/c/help) and include your application version, your Speckle
    connector version, and a copy of the log.
  </Accordion>

  <Accordion title="Why can't I add a new account?">
    Signing in opens a browser page for your Speckle server. If it doesn't open, or it never returns
    you to the connector, check that you can reach your server in your browser, update the connector
    to the latest version, and try again.
  </Accordion>

  <Accordion title="My connector asks for Speckle Desktop Services. What do I do?">
    Older connector versions sign in through Speckle Desktop Services, which is deprecated. Update the
    connector to the latest version. If you must stay on the older version, search for **Speckle
    Desktop Services** in Windows search and run it before signing in.
  </Accordion>

  <Accordion title="How do I uninstall my connector?">
    All Speckle connectors are installed like any other program. You can uninstall them directly from
    your system's `Applications`. For a full uninstall, also remove **Speckle Desktop Services** if it
    is installed.
  </Accordion>

  <Accordion title="How do I update my connector to the latest version?">
    You can always download the latest version of the connector [in the web
    app](https://app.speckle.systems/connectors). If a new version of the connector is available, you
    will also see a notification in your connector UI.
  </Accordion>
</AccordionGroup>

## Publishing a Model

<Steps>
  <Step title="Select Publish">
    <Frame>
      <img src="https://mintcdn.com/speckle/9rxydi43nI7TTwOi/images/connectors/dui-2-publish-only.jpg?fit=max&auto=format&n=9rxydi43nI7TTwOi&q=85&s=511fc917d07580207395f65a1388b283" alt="Publish-only" width="1620" height="1080" data-path="images/connectors/dui-2-publish-only.jpg" />
    </Frame>
  </Step>

  <Step title="Choose a project">
    * Select an existing project - or select **New Project** to create one

    <Frame>
      <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/connectors/dui_publish_2.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=0857c7878df8d5931bc9b6dacaeda8f9" alt="Publish" width="1296" height="864" data-path="images/connectors/dui_publish_2.jpg" />
    </Frame>
  </Step>

  <Step title="Choose a model">
    * Select an existing model - or select **New Model** to create one

    <Frame>
      <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/connectors/dui_publish_3.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=99565734d02032e77db685dde97bf7b5" alt="Publish" width="1296" height="864" data-path="images/connectors/dui_publish_3.jpg" />
    </Frame>
  </Step>

  <Step title="Select objects to publish">
    1. In your application viewport, select the elements you want to publish.
    2. Select **Publish**.

    <Frame>
      <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/connectors/dui_publish_4.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=918d1db7fb1605dd7365b66a70455af3" alt="Publish" width="1296" height="864" data-path="images/connectors/dui_publish_4.jpg" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/speckle/YrJFGLA1qDYoqsMd/images/connectors/dui_publish_5.jpg?fit=max&auto=format&n=YrJFGLA1qDYoqsMd&q=85&s=d0f1dff98af5354bdac9758c6acd04df" alt="Publish" width="1296" height="864" data-path="images/connectors/dui_publish_5.jpg" />
    </Frame>

    3. Your model is now published to Speckle and is available to the rest of your team.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="What types of elements can I publish from Navisworks to Speckle?">
    All visible objects in the Navisworks scene can be published to Speckle. This includes geometry
    from appended NWC, DWG, IFC, and RVT files. The export includes: - object geometry (as meshes) -
    model hierarchy - attached properties (from source files) - file metadata
  </Accordion>

  <Accordion title="Can I publish only selected objects or specific appended files?">
    You can publish any of the following:

    <ul>
      <li>A manual selection of objects, which can include a file in the scene.</li>
      <li>A saved selection set</li>
      <li>A saved search set</li>
      <li>A saved view</li>
    </ul>

    Use the connector UI to choose which of these to send to Speckle.
  </Accordion>

  <Accordion title="Can I include saved timeliner information, redlines, or clash results?">
    Not at this time. The Navisworks connector currently focuses on object geometry and properties.
    Markups and clash results are not exported.
  </Accordion>

  <Accordion title="Can I preserve selection sets or search sets when publishing?">
    While selection and search sets themselves are not preserved as named sets in Speckle, as that
    concept doesn't yet exist on the web, you can use them as filters to choose what objects to send.
    The objects they reference will be exported with full geometry and metadata.
  </Accordion>

  <Accordion title="How do I ensure my Navisworks model is correctly positioned in Speckle?">
    The connector uses the world coordinate system as defined in Navisworks. If your model has an
    offset origin, it will be preserved in the Speckle model. To align with other models, ensure a
    consistent shared coordinate system.
  </Accordion>

  <Accordion title="My Navisworks model is in real-world coordinates, how can I move it closer to the origin?">
    You can use the **Transform** option in the Speckle connector to apply a translation to your model
    before publishing. This allows you to adjust the position without modifying the original
    Navisworks file.
  </Accordion>

  <Accordion title="Do custom properties (e.g., element metadata or quantities) get published?">
    Yes. All custom properties attached to elements in Navisworks are included in the Speckle export.
    These can be viewed in the Speckle web viewer by selecting an object and inspecting its
    properties.
  </Accordion>

  <Accordion title="Will properties added with DataTools be sent?">
    Yes, any properties added to objects using DataTools in Navisworks will be included in the export
    to Speckle. Ensure the properties are visible in the object inspector before publishing.
  </Accordion>

  <Accordion title="Can I export the model as a tree structure or a flat list?">
    By default, the connector exports objects as a flat list. If you want to preserve the model's
    hierarchy (tree structure), enable the **Preserve Hierarchy** option in the connector UI before
    publishing. Regardless of this setting, all elements will include a <code>path</code> property
    that records their original hierarchy within the model.
  </Accordion>

  <Accordion title="How reliable are large file uploads in recent versions?">
    Recent connector updates resolved a threading issue in upload handling and significantly reduced
    memory pressure for large models. In practice, large Navisworks files that previously failed are
    now more likely to publish successfully.
  </Accordion>

  <Accordion title="Why does my model have the wrong colors in the web browser viewer?">
    In the viewer, select the **View Modes** button in the side bar, and switch the view mode to
    **Shaded**. If you still don't see your object colors, let us know in our [Community
    Forum](https://speckle.community/c/help)
  </Accordion>

  <Accordion title="Are bitmap or image-based material textures supported?">
    **Image texture files are not supported.** Speckle does **not** transfer bitmaps or other image maps (such as JPG or PNG files) embedded in materials from the source application.

    Speckle **does** carry [PBR-style material data](/developers/sdks/python/guides/understanding-speckle-mesh#render-materials) in general—where a connector maps to it, materials can include properties such as base colour, opacity, metalness, roughness, and emissive colour. That is not the same as shipping texture images: you get numeric material parameters, not image assets used for wood grain, brick patterns, and similar in the authoring tool.

    Different materials can still appear separately in the destination with distinct colours and PBR fields. What you see may look closer to a consistent shaded or PBR preview than to the full render-appearance with image maps in tools such as Revit or SketchUp. To use image textures in your target application, apply or remap them locally after you publish or load.
  </Accordion>

  <Accordion title="Why are some objects that I published missing from my model?">
    After you publish a Speckle model, click on the **Report** button to see any errors that may have
    occurred. Click on any item in the report to highlight that item in your application. Some objects
    may not be supported for publishing.
  </Accordion>
</AccordionGroup>

## Loading a Model

<Note>The {app_3} connector is publish-only.</Note>
If you would like to be able to load a model into {app_3}, please reach out on our Community Forum:
[https://speckle.community/c/features](https://speckle.community/c/features/7) Include the following
information: - Which application your Speckle model is published from - Why you want to load your
model into {app_3}- How frequently you would use this workflow (daily, weekly, monthly, longer).


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