Open Settings

Open Settings opens the central BIMO Toolbar configuration window. Use it to change general options, configure commands with parameters, manage presets and variants, and open the local configuration folder.

Find the command in BIMO > Stay up to date > Open Settings.

When To Use It

• Prepare command parameters before execution.

• Create or update a reusable preset.

• Assign presets to command variants.

• Enable experimental BIMO functionality.

• Add a user-created command from a Dynamo .dyn file.

• Open local configuration files for backup or troubleshooting.

Requirements

Open Settings is available even when no Revit project is open. It does not require an active document or view and does not modify the model by itself.

Some fields depend on the Revit version. For example, Dynamo command sources is displayed only in Revit 2023 and newer.

Window Layout

The left side contains two sections:

• General — global BIMO Toolbar settings;

• Commands — settings for published commands that support configurable parameters and presets.

At the bottom of the window:

• Ok saves changes;

• CANCEL closes the window without writing changes;

• location opens the local configuration folder;

• ? opens the Open Settings help page on the BIMO website.

The window remembers the last selected General item and command item.

General Settings

In the current implementation, General shows user-facing properties that have an explicit display name.

General settings do not use presets or variants.

After changing options that affect Ribbon command registration — such as alpha functionality or Dynamo command sources — a Revit restart may be required.

Which Commands Appear Under Commands

The Commands section is not the complete BIMO Library list.

A command is added automatically when it:

• is present and visible in the active Ribbon scheme;

• declares a settings model through the Presets attribute;

• is available from the main or generated command assembly.

Commands are sorted by name.

A command may therefore be absent when:

• it has no user-configurable parameters;

• it is hidden by the active Ribbon scheme;

• it has not been registered after changing user-command sources;

• its availability depends on the Revit version or product configuration.

Managing Presets

Commands with settings provide a preset selector and an action menu:

Creating, copying, renaming, resetting, and deleting are written permanently only after clicking Ok.

Variants

Each preset can be assigned to:

• normal execution without a variant number;

• Variant #1;

• Variant #2;

• Variant #3.

Within one command, a variant number can belong to only one preset. Assigning the same number to another preset removes the previous assignment.

Variants let dedicated Ribbon buttons or shortcuts run a prepared command configuration when that integration is available.

Before quick execution, confirm that the intended preset is assigned to the correct variant.

Saving And Canceling

When you click Ok, BIMO:

1. saves the preset collection and selected preset for every loaded command;

2. saves the General settings;

3. stores the window navigation state;

4. closes the dialog.

Clicking CANCEL or closing the window without confirmation does not write the edits to the local configuration files.

Saving settings does not execute a command or change the active model. The saved values are used during later command runs.

Local Configuration Folder

The location button opens:

When the directory does not exist, BIMO shows an information message instead of opening File Explorer.

The folder contains the current Windows user's local settings files. Use it for:

• configuration backups;

• sharing files with BIMO support;

• diagnosing damaged or unexpected settings;

• manually comparing configurations.

Do not edit JSON files manually without a backup. Invalid formatting or incompatible values can reset settings or cause incorrect behavior.

Typical Workflow

1. Run Open Settings.

2. Select General or a command under Commands.

3. Select an existing preset or create a new one.

4. Change the required values.

5. Assign a Variant number when needed.

6. Click Ok.

7. Restart Revit when the change affects command registration in the Ribbon.

Impact And Limitations

• Open Settings does not execute selected commands or modify model elements.

• Saved values may affect a future run of a command that changes the model.

• The command list contains only visible commands that support settings.

• Hidden commands are excluded even when their class declares Presets.

• General shows only properties with an explicit user-facing display name in the source code.

• Changes that affect Ribbon composition may not apply immediately.

• Local settings are not synchronized automatically between computers.

Troubleshooting

Related Pages

• BIMO Toolbar Settings

• Presets and Variants