Add an advanced option to the user.ini file

You can save your personal user settings in the user.ini file.

The user.ini file is located in the same location as the user-specific options.bin file, such as ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UserSettings.

Note:

We recommend that you add only system-specific advanced options to the user.ini file.

You can also add model-specific advanced options, but the model-specific advanced options only affect new models that you create. This is because only the new advanced options that do not yet exist in options_model.db or options_drawings.db are taken into account. For more information, see Files storing options and advanced options.

Adding user-specific advanced options in user.ini might not work as desired as options.bin is loaded after user.ini and might override the value.

Tip:

When you are moving to a new version of Tekla Structures, you can use the Migration Wizard to automatically copy your user.ini file to the new version. The Migration Wizard appears once you start Tekla Structures for the first time after installation.

In Windows Explorer, right-click the user.ini file, select Open with, then select a text editor from the list of available programs.

On a new line, enter set, then a space, then the name of the advanced option followed by an equal sign, and then the value in a single line.

Tekla Structures only reads lines in the initialization file that start with set.

Example:

set XSDATADIR=C:\ProgramData\Trimble\Tekla Structures\2024


Possible values	Example
`TRUE` `FALSE`	`set XS_DISABLE_WELD_PREP_SOLID=TRUE` `set XS_UNDERLINE_AFTER_POSITION_NUMBER_IN_HARDSTAMP=FALSE`
`1`	`set XS_SINGLE_CLOSE_DIMENSIONS=1`
`0`	`set XS_SINGLE_USE_WORKING_POINTS=0`
string value	`set XS_USER_DEFINED_BOLT_SYMBOL_TABLE=bolt_symbol_table.txt`
switches	`set XS_ASSEMBLY_FAMILY_POSITION_NUMBER_FORMAT_STRING=%%TPL:PROJECT.NUMBER%%` Use two switches. NOTE: If you are defining the switch in an .ini file, use double percent signs %%xxx%% around the switch.

Save the changes to the user.ini file.
Restart Tekla Structures to apply the changes.