Skip to main content

Custom component example: define a nested custom component

Modified: 30 Oct 2025 Tekla Structures 2026
2026
Tekla Structures

You can define more complex custom components by joining two or more components together as a nested component. This allows you to create smaller, simpler components and wrap them up into a single component. The original components become sub-components in the nested component. Nested components are typically used with precast and cast-in-place components, such as with embeds.

Do not nest components more than necessary. If you nest more than two levels, you might run across some limitations. To view the different component levels in a nested custom component, hold down the Shift key and scroll with the mouse wheel.

  1. In the model, create the system components that you want to include in the nested component.
  2. In the model, create the other component objects that you want to include in the nested component.

    You can create the component objects either by creating a component and then exploding it, or by creating the component objects manually.

  3. Click the Applications & components button in the side pane to open the Applications & components catalog.
  4. Click the Access advanced features button and select Define custom component....

    The Custom component wizard dialog opens.

  5. In the Type list, select the type for the nested custom component.
  6. In the Name box, enter a unique name for the nested component.
  7. If needed, modify the other properties on the Type/Notes tab, Position tab, and Advanced tab, and then click Next >.
  8. In the model, select the components and any other objects you want to include in the nested component, and then click Next >.
  9. Follow the instructions in the Custom component wizard to continue.

    You will be asked to select the main and secondary parts for the nested component. Depending on the component type that you selected in a step 5, you may also have to define other properties, such as detail or seam position.

  10. When you are happy with the settings, click Finish to create the nested component.

    The component is added in the model and in the Applications & components catalog.

  11. In the model, select the nested component you just created, right-click and select Edit custom component.

    The custom component editor opens. The sub-components are shown in the Custom component browser, together with the other component objects:

  12. If you want to adapt the custom component to changes in the model, you can start building dependencies between component objects and model objects.
Warning:

If you use a component of the type plug-in as a sub-component of a nested component, and change the sub-component's properties in the custom component editor, note that those changes may be lost when you save the nested component and use it in a model.

To prevent losing any properties, link a variable to each plug-in property that you want to keep. You can also use component attribute files to do this. For more information, see Examples of parametric variables and variable formulas in custom components.

Submit

Table of Contents