Firm Folder

Software version: Not version-specific

Last updated October 29, 2019 by Trimble Solutions UK

Not environment-specific

Firm Folder

Creating a Firm Folderfolder that is used for storing Tekla Structures-related files customized for a particular organization

A Tekla Structures user can, for example, customize a company’s cloning templates and save them in a sub-folder located under the firm folder. After this, the customized cloning templates can be used in all projects carried out for the company.

This is a guide to creating a firm folder in which various files and settings can be placed, making them available for all models.

Files in the firm folder are read before files in the system folderfolder that is used for storing Tekla Structures-related files that define default settings

and after files in the model folderfolder that is used for storing files associated with a model

Tekla Structures stores all files associated with a model in a folder it creates with the same name as the model database (.db1).

In multi-user mode all users access the same model folder.

. So for example if a template file with the same name is in all three, the one in the model folder will be read and the other two ignored.  If the one in the model folder is removed the file in the firm folder will then be read. This means that files can be copied from the system folder, placed into a firm folder, and modified without making any changes to the system files.

• The first thing to do is create the firm folder itself. This can be called anything you want but for this guide we’ll call the folder Firm.

• Also, we’ll create a folder called Company-Settings elsewhere. This folder will be located in the TeklaStructures folder.

• We’ll now create an initialization filetext file that contains user interface definitions, start-up parameters, default settings, or advanced options

Initialization files are used when starting Tekla Structures and they can contain system-specific and user-specific advanced options that are used to configure Tekla Structures for different standards and the user’s individual style of working.

Initialization files have the file name extension .ini.

in the firm folder. Create a text file in the firm folder and call it firm.ini.

• We can use this firm.ini file to set various advanced optionssettings used to customize Tekla Structures for specific companies, standards, users, or user groups

In Tekla Structures, advanced options are settings that are used, for example, in a specific project or geographical area, or by a specific company.

In Tekla Structures, advanced options usually begin with the initials XS and are followed by the name of the function, for example XS_BACKGROUND_COLOR.

we want for each model.

• Open the firm.ini file and type the following line:       


• Save the file and open a Tekla model.

• Open component 101 and save some settings. This will create a file in your model attributes folder.

• Copy this file into your firm folder.

• Now we’ll need to tell Tekla to read the firm folder and firm.ini file when it starts up. To do this we’ll need to add a couple of lines to the user.ini file.

• The user.ini file can often be hidden away. The easiest way to find its location is through the Directory browser macrosaved series of actions that includes instructions for a program

Macros are located in the applications and components catalog. They are recorded or created manually and stored as .cs file in a folder defined with the advanced option XS_MACRO_DIRECTORY.

Macros can, for example, be used for creating drawings or reports.

Macros are sometimes used to run an application.

in Applications & components on versions after 21.1. See the article Check and change Tekla Structures file and folder locations in Directory browser


In older versions, go to Tools>Macros and run the macro:

If you do not want to use the macro, the file location in Windows for versions 2019 onwards is C:\Users\<username>\AppData\Local\Trimble\Tekla Structures\<version>\UserSettings and for earlier versions it is C:\Users\<username>\AppData\Local\Tekla Structures\<version>\UserSettings. Note that in order to access this location, you need to have hidden folders visible in Windows

• Clicking on User Settings will open the folder where the user.ini file is located.

• Open this file, remove the rem from in front of the XS_FIRM line and paste the path of the firm folder location here:

• We’ll also need to call in the firm.ini file so the settings in here are being used. Under the XS_FIRM line add the following line:

call C:\TeklaStructures\Company-Settings\Firm\firm.ini

• Save the file and exit out of Tekla

• Reopen Tekla and start a new model. The advanced option XS_USE_ASSEMBLY_NUMBER_FOR should now be set to MAIN_PART and connection 101 should have the settings saved earlier available to load

See additional information in the article Create project and firm folders

firm folder

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Content rating: 
Average page rating: 3.8 (9 votes)
Refresh page after voting to show updated result.