Skip to main content

Create collections

Modified: 22 May 2026 Tekla Structures - Not version-specific
Not version-specific
Tekla Structures

A collection is a group of settings that belong to the same category. You can combine different collections to build project settings.

Each collection can hold files that are organized into categories and optional Tekla Structures extension packages (.tsep packages). For example, you can create a collection to define a custom ribbon with buttons for .tsep extensions.

Create a collection

Creating a collection helps you organize content into categories to simplify the creation of project settings.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Click Add new, then select Collection.
  4. Enter a unique name and a description.
  5. Upload a thumbnail image.
  6. Click Create.

The collection opens in the settings editor.

Next, add content to categories in the collection. You can add content manually or use AI to automatically categorize content.

Create a company collection

Company collections are an alternative to the firm folder for users who start Tekla Structures using Tekla Launcher. You can use a company collection to enforce standards for all users in your company.

Company collections are available in Tekla Launcher under Apply company settings when users create new models. You can create multiple company collections, but each model can only use one company collection.

Company collections can be overridden by third-party users if they are participating in a project and have their own collections.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Click Add new, then select Company collection.
  4. Enter a unique name and a description.
  5. Upload a thumbnail image.
  6. Click Create.

The collection opens in the settings editor.

Next, add content to categories in the collection. You can add content manually or use AI to automatically categorize content.

Add content to a collection or a company collection manually

Before you begin, create a collection or a company collection.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the collection or company collection that you want to add content to.
  4. Click the category that you want to add content to.
    • Catalogs: Catalog databases used by Tekla Structures (typically mapped to `XS_PROFDB`).
    • Documents: Settings for drawings.
    • Analysis: Settings for customizing analysis engines in Tekla Structures.
    • Advanced options: Allows users to define values for advanced options in .ini files.
    • Modeling: Settings for customizing modeling.
    • Applications and components: Settings for Tekla Structures extensions and components.
    • Interoperability: Settings for import and export, including IFC.
    • User interface customization and branding: Settings for customizing the Tekla Structures user interface, such as custom tabs, ribbons, and property panes.

    Each category includes more specific subcategories.

  5. Expand the subcategory that the content belongs to.
  6. Drag and drop files to the Drag files here. area, or browse for files.

    Each subcategory has specific file requirements that are shown when you expand the subcategory. Files must have the correct name and file extension to be added to a subcategory.

Use AI to automatically categorize content in a collection

You can use AI tools in the project settings sandbox to upload and automatically categorize content in existing configuration files for Tekla Structures.

Before you begin, create a collection or a company collection.

The AI tools automatically sort the settings from the files into category-specific collections.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the collection or company collection that you want to add content to.
  4. Drag and drop the folder that contains the files to the Upload a folder to use AI to create your collection area, or browse for the folder.

    The AI tools analyze the files and suggest a category and subcategory for each file.

  5. Review the suggested categories.
    • If the suggestion is incorrect, select a different subcategory.
    • If a file is shown as uncategorized, select a subcategory for the file or remove the file from the list.
    Tip: To filter the list, select Show only uncategorized files.
  6. Click Upload.

Validate a collection or company collection

Validate a collection to check that the collection contains all the needed files.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the collection or company collection that you want to validate.
  4. Click Validate.

    The validation tool checks the files in the collection. If any files are missing, the validation tool shows a list of the missing files.

  5. Resolve issues with missing files in one of these ways:
    • Drag and drop the files to the Validation tool window to add the missing files.
    • Click Remove file to remove the missing files.
  6. Click Save.

    You are prompted to confirm your changes.

  7. Click Save.

When the collection contains only valid files, it is ready to be published.

Publish a collection or company collection

To make the collection available for use in project settings, publish the collection.

Before you publish a collection or company collection, validate the files in the collection.

  1. Sign in to the Project Settings Management Console.
  2. In the navigation pane on the left, click the Project settings sandbox icon.
  3. Open the collection or company collection that you want to publish.
  4. Click Publish.
  5. Enter the publishing information.
    • Version: Enter a version number in semantic versioning 2.0 format. For example, 1.0.0 for the first version of the collection.

      This version number is used to keep track of changes to the collection. It does not have to match a Tekla Structures version number.

    • Minimum supported Tekla Structures version: Enter the minimum version of Tekla Structures that is compatible with this environment. Only versions 2025 or later are supported.

    • Default storage location: To change the region where data related to this collection is store, select a location.

      By default, the default storage location that you selected when you set up your user information is used.

    • Description of the published changes: Enter a short description of the changes in the version that you are publishing.

  6. Click Publish.

Publishing the collection can take a few minutes. When the collection has been published, it is visible in the package explorer.

Next, create project settings and add the collection to the project settings.

Submit

Table of Contents