Preferences

Preferences let you customize how individual Amorphous tools behave. Unlike the main Settings dialog (which manages your account and license), Preferences focuses on tool-specific configuration options that affect how each add-in operates.

Accessing Preferences

1. Go to the Amorphous ribbon tab
2. Click the Settings dropdown (not the main button, but the dropdown arrow)
3. Select Preferences

The Preferences dialog opens with a navigation sidebar on the left listing each tool that has configurable settings.

Dialog Overview

Element	Description
Navigation sidebar	Lists all tools with preference pages. Click a tool name to view its settings.
Content area	Displays the selected tool’s configurable options
Close button	Click or press ESC to close the dialog

Tip

Settings are saved automatically as you change them. There’s no “Save” button - your changes take effect immediately.

---

Settings Storage

Preferences are stored locally on your computer in:

%AppData%\Amorphous\config.json

Key Points

• Per-user: Settings are specific to your Windows user account
• Per-machine: Settings don’t sync between computers
• Persistent: Settings survive Revit restarts and updates
• Human-readable: The config file is JSON and can be manually edited if needed

Caution

While the config file is editable, making changes while Revit is running may cause issues. Close Revit before manually editing configuration files.

Resetting Preferences

To reset all preferences to defaults:

1. Close Revit
2. Navigate to %AppData%\Amorphous\
3. Delete or rename config.json
4. Restart Revit

A new config file with default values will be created on first use.

---

Preferences vs. Settings

Amorphous has two configuration dialogs:

Dialog	Purpose	Access
Settings	Account management, license status, privacy options, update checks	Settings button (main)
Preferences	Tool-specific behavior configuration	Settings dropdown > Preferences

Use Settings for:

• Viewing license status
• Managing account information
• Configuring privacy/telemetry options
• Checking for updates

Use Preferences for:

• Adjusting how individual tools behave
• Setting default values for tool parameters
• Enabling/disabling automatic UI features

---

Keyboard Shortcuts

Key	Action
ESC	Close the Preferences dialog
Tab	Move to next input field
Shift+Tab	Move to previous input field

---

Related Pages

• Settings - Account and license management