Distribute customized ribbons using a firm or environment folder

Last updated March 10, 2020 by Tekla User Assistance tekla.documentation@trimble.com

Software version: 

Distribute customized ribbons using a firm or environment folder

Distribute customized ribbons using a firm or environment folder

You can distribute customized ribbon files to other users in the company by placing the ribbon files in a firm or environment folder (not in the project folderfolder that is used for storing Tekla Structures-related files customized for a particular project

). For example, the administrator can create company ribbons and save them in the 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.

. These ribbons will be displayed in the Tekla Structures user interface for all users who use the same firm folder.

Add ribbons to the firm or environment folder

  1. In the Ribbon editor, create the modeling and drawing ribbons that you want to share.

    The ribbons are saved in the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Ribbons folder.

    If you cannot find the folder, ensure that you are able to view the hidden files and folders on your computer.

  2. Copy the entire \Ribbons folder either to your company's firm folder or to the system folder.
  3. If the ribbon contains user-defined commands, create a subfolder named \Commands on the same level as the \Ribbons folder, and copy the UserDefined.xml file from the ..\Users\<user>\AppData\Local\Trimble\TeklaStructures\<version>\UI\Commands folder to the \Commands folder you just created.
  4. Restart Tekla Structures.

Loading order of custom ribbons

Tekla Structures loads the ribbons in the following order:

  1. Tekla Structures default ribbon
  2. Company ribbons in the environment folders
  3. Company ribbons in the firm folder
  4. User-defined ribbons under %localappdata%

Note that the ribbons which are loaded later will override previously loaded ribbons that have the same configuration + editing mode combination. For example, a ribbon defined in the firm folder will take precedence over the ribbons in the environment folders.

If you have a customized ribbon in the ..\Users\<user>\AppData\Local\Trimble\Tekla Structures\<version>\UI\Ribbons folder, it will take precedence over company ribbons. To override this, open the Ribbon editor and click Restore. The ribbon in the environment or firm folder will now be used. Alternatively, you can remove or rename your own customized ribbons.

Naming convention for ribbon files

The customization tool saves the custom ribbons as .xml files. The naming convention for these files is:


The name consists of an internal configuration name, a separator of two dash characters (--), an internal editing mode name, and the file name extension .xml. For example, the Full license modeling ribbon is called albl_up_Full--main_menu.xml.

Configuration identifier



Construction Modeling












Precast Concrete Detailing


Rebar Detailing


Steel Detailing




Project Viewer

Editing mode



Modeling ribbon


Drawing ribbon


Importing ribbon

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: 5 (1 vote)
Refresh page after voting to show updated result.