Settings is the central BIMO Toolbar window for global Toolbar settings and individual command settings.
Use it when you need to prepare a command before running it, save repeatable settings, add a user-created Dynamo command source, or open the local settings folder for troubleshooting.
Open Settings
Open the BIMO tab in Revit.
Click Open Settings.
In the default ribbon, the command is in the Stay up to date panel. If your organization uses a customized BIMO ribbon, the command location may be different.
Window Layout
The left side of the window has two sections:
General - global BIMO Toolbar settings.
Commands - settings for commands that support configurable parameters.
At the bottom of the window:
Ok saves changes.
CANCEL closes the window without saving.
location opens the local settings folder.
? opens Settings help.
General Settings
General contains global BIMO Toolbar options. These settings are not tied to one command.
In the current implementation, these user-facing settings are available:
Setting | What It Does |
|---|---|
Use alpha features | Enables experimental BIMO Toolbar functionality. For example, it is required for creating user commands from Dynamo |
Dynamo command sources | A list of |
General settings do not use presets or variants because they are global Toolbar settings.
Dynamo Command Sources
In Dynamo command sources, you can add a source for a user-created command from a .dyn file.
Each source shows:
GUID - the internal source identifier; you do not need to change it.
Name - the future command name on the toolbar.
Path - the path to the
.dynfile.
After adding or changing sources, restart Revit so BIMO Toolbar can create and register the commands.
See also: Create commands from Dynamo .dyn.
Command Settings
The Commands section does not show the full BIMO Library list. It shows commands that have configurable settings.
For example, it may include:
Run Python;
Run Dynamo;
other commands that support settings.
If a command is not listed under Commands, it is not necessarily an error. The command may not have user settings, or it may be hidden in your ribbon configuration.
Presets And Variants
For commands with settings, BIMO Toolbar shows a presets block:
choose an existing preset;
create a new one with New;
duplicate the current one with Copy;
rename it with Rename;
reset values with Reset;
delete it with Delete;
assign a preset to
Variant #1,Variant #2, orVariant #3.
This workflow is described separately: Presets and Variants.
Saving Changes
Changes are saved only after you click Ok.
If you click CANCEL or close the window without confirming, changes are not saved.
For commands with presets, BIMO saves the selected preset and its values. For General settings, BIMO saves global Toolbar options.
When To Restart Revit
Restart Revit when a setting affects which commands appear on the toolbar.
In practice, this matters after:
enabling or disabling Use alpha features;
adding, removing, or changing Dynamo command sources;
a user-created command does not appear after changing sources.
Regular command parameter changes are normally used the next time you run that command and do not require restarting Revit.
Where Settings Are Stored
BIMO Toolbar stores local settings in the current Windows user profile:
Click location in the Settings window to open this folder.
Settings files are stored as JSON. Usually, you do not need to edit them manually. Use this folder for backup, troubleshooting, or sharing settings with support.
Practical Examples
Enable User-Created Dynamo Commands
Open Open Settings.
Go to General.
Enable Use alpha features.
Add a
.dynfile to Dynamo command sources.Click Ok.
Restart Revit.
Find Run Python Settings
Open Open Settings.
In Commands, select Run Python.
Choose or create a preset.
Adjust the command fields.
Click Ok.
Open the Settings Folder
Open Open Settings.
Click location.
Use the opened folder for backup or troubleshooting.
Warnings
Command settings affect future command launches. If a command changes the model, saved values can affect the result in the active Revit document.
Before quick-launching through a variant, check that the correct preset is assigned and the correct document is active.
Troubleshooting
I Do Not See a Command In Commands
The Commands section shows only commands with configurable settings. Commands without settings may not appear there.
I Do Not See Dynamo Command Sources
Check:
whether you are using Revit 2023 or newer;
whether you are in the General section;
whether the required functionality is available in your BIMO Toolbar version.
My Changes Did Not Apply
Check:
whether you clicked Ok;
whether you closed the window with CANCEL;
whether this setting requires restarting Revit.
I Need To Find Local Settings Files
Open Open Settings and click location.
In Short
General controls global BIMO Toolbar settings.
Commands contains settings for commands that support parameters.
Ok saves changes; CANCEL discards them.
For user-created Dynamo commands, enable Use alpha features, add a
.dynsource, and restart Revit.Local settings can be opened with location.