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

# How to use Speckle for Tekla Structures

> Step-by-step guide for using the Tekla Structures connector

export const app_3 = "Tekla Structures"

export const app_2 = "Tekla Structures"

export const app_1 = "Tekla Structures"

export const app_0 = "Tekla Structures"

export const versions_0 = "2023, 2024 & 2025"

export const os_0 = "Windows"

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

## Setup

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

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

    <Frame>
      <img src="https://mintcdn.com/speckle/5UIlyL-HMgYLn0Bd/images/connectors/tekla_toolbar.jpg?fit=max&auto=format&n=5UIlyL-HMgYLn0Bd&q=85&s=b753e5d145bb5899424403663337bb51" alt="Tekla toolbar" width="1296" height="864" data-path="images/connectors/tekla_toolbar.jpg" />
    </Frame>

    2. Select **Speckle** to open the Tekla Structures 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: Make sure you are **not** selecting **Run as administrator** when installing - this will install for the administrator user, and not your own user.
    Instead, double-click the `.exe` or right-clicking and then selecting `Open` to run the installer.
    Installation issues can also be caused by conflicting plugins.

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

    * 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`. Please report your problem in our [Community
    Forum](https://speckle.community/c/help) and include the following information: - Your application
    version - Your Speckle connector version - A copy of the log
  </Accordion>

  <Accordion title="Why can't I add a new account?">
    This can happen if our **desktop service** isn't running. Desktop Service is used for
    authenticating new accounts. If it's not running, search for **Speckle Desktop Services** in
    Windows search and run it.
  </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, you should also remove **Speckle Desktop
    Services** as well as your Speckle connector.
  </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>

<AccordionGroup>
  <Accordion title="The Speckle tab doesn't appear in my Tekla Structures ribbon after installation">
    If the Speckle connector doesn't appear in the Tekla ribbon after installation, this is usually
    caused by the connector files not being copied to the correct location. This can happen due to:

    * VPN or IT security restrictions blocking file operations - Tekla being installed on a
      non-standard drive - Insufficient permissions during installation To resolve this: 1. Check if
      the connector files exist in the correct Tekla extensions folder: - For Tekla 2025:
      `C:\TeklaStructures\2025.0\Environments\common\extensions\Speckle3TeklaStructures` - For Tekla
      2024: `C:\ProgramData\Trimble\Tekla
          Structures\2024.0\Environments\common\extensions\Speckle3TeklaStructures` - For Tekla 2023:
      `C:\ProgramData\Trimble\Tekla
          Structures\2023.0\Environments\common\extensions\Speckle3TeklaStructures` 2. If the
      `Speckle3TeklaStructures` folder is missing, manually copy it from the Speckle Manager
      installation directory to the appropriate Tekla extensions folder above. 3. Restart Tekla
      Structures after copying the files. 4. Verify the connector appears in the **Applications &
      Components** panel within Tekla. If you continue to experience issues, please contact support or
      visit our [community forum](https://speckle.community).
  </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 Tekla Structures objects can I publish to Speckle?">
    All selectable model objects can be published, such as beams, plates, and bolts. Each object is published as a `TeklaObject` and contains the following information:

    * Type
    * Render Material
    * Custom Properties (e.g. Report)
  </Accordion>

  <Accordion title="How do I see the custom properties on my published Tekla Structures objects, like reports?">
    All custom properties can be found under the `properties` field when you select and view a Tekla Structures object in your browser.Custom properties vary depending on the type of object, and can include:

    * Report (e.g. `Area`, `Volume`, or `Phase`)
    * User-Defined Attributes
    * Beams: `profile` and `material`
  </Accordion>

  <Accordion title="Which object properties do not get published with the Tekla Structures connector?">
    Currently\*\*,\*\* the following properties are *not* published on objects:

    * Assemblies
    * Drawing layout and title blocks
    * Numbering series and sequence settings
  </Accordion>

  <Accordion title="Can I publish objects from a drawing view?">
    No, you can not publish from drawing views.
  </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).