Settings

The Settings dialog is the central hub for managing your Amorphous account, controlling privacy preferences, and checking for software updates. It provides quick access to your account status, subscription tier, and offline access information.

Getting Started

Find Settings on the Amorphous ribbon tab in the Settings panel. Click the main Settings button to open the dialog.

Tip

The Settings button is a split button. Click the main button for Settings, or click the dropdown arrow to access Preferences for tool-specific configuration.

---

Account

The Account section displays your current sign-in status and subscription information.

Element	Description
Email	Your registered email address, or “Not signed in” if logged out
Source Indicator	Shows whether you installed via Website or Autodesk App Store
Offline Status	When offline, displays remaining days until reconnection is needed
Sign In / Sign Out	Button to manage your account access

Signing In

First-time users verify their email with a secure link:

1. Open Settings from the ribbon
2. Click Sign In
3. Enter your email address and click Send
4. Check your inbox for a verification email from Amorphous
5. Click the link in the email to verify
6. The dialog automatically detects verification and signs you in

Tip

Check your spam folder if you don’t see the email within a minute. You can also click Resend email in the dialog to send a new link.

Returning users: If you’ve signed in before, you’ll be signed in automatically without needing to verify again.

Signing Out

1. Open Settings
2. Click Sign Out
3. Confirm when prompted

Caution

After signing out, you must sign back in to run any Amorphous commands. Running a command without being signed in will prompt you to sign in.

Offline Access

Amorphous supports offline use for a limited time. When you’re online, your access token automatically refreshes each time you start Revit. If you go offline:

• The Settings dialog shows how many days remain before you need to reconnect
• Once the offline period expires, you’ll need an internet connection to sign in again
• The default offline period is 30 days

---

Privacy & Data

Control how your data is collected and used.

Setting	Description	Default
Enhanced Usage Data	Share detailed diagnostics to help improve the add-ins	On
Monthly Newsletter	Receive monthly updates about new features and tips	On

Enhanced Usage Data

When enabled, anonymous usage statistics help us understand which features are used most and identify issues. This data never includes your project files or personal information beyond your email (when signed in).

Monthly Newsletter

Subscribe to receive monthly emails about:

• New feature announcements
• Tips and best practices
• Product updates

Changes to these settings are saved automatically and synced to the server when online.

---

Updates

The Settings dialog automatically checks for updates when opened. The Updates section shows your current status:

Update States

State	Description
Checking	Currently checking for updates
Up to date	You have the latest version installed
Update available	A new version is ready to download
Update pending	Downloaded and will install when Revit closes
Error	Unable to check (click Retry to try again)

Downloading Updates

When an update is available:

1. The new version number displays in cyan
2. Click Download Update to download the installer
3. Click Release Notes to view what’s new on GitHub
4. After download completes, a confirmation appears
5. The update installs automatically when you close Revit

Note

For Autodesk App Store installations, the Download button opens the App Store page instead of downloading directly.

Update Installation

Once downloaded, updates install automatically:

1. Close Revit normally
2. The MSI installer launches automatically
3. Follow the installation prompts
4. Restart Revit to use the new version

---

Support

Have feedback, found a bug, or want to request a feature? Click Send Feedback to open the feedback form on the Amorphous website.

---

About

The About section displays technical information:

Field	Description
Add-in Version	Current installed version of Amorphous add-ins
Revit Version	The Revit version you’re running (2022-2026)
Distribution	How you obtained the software (Website or Autodesk App Store)
Website	Link to amorphous.dev

---

Keyboard Shortcuts

Key	Action
ESC	Close the Settings dialog

---

Tips

• Quick access: The Settings dialog opens from any view in Revit
• Automatic refresh: Your access token refreshes automatically each time you start Revit (when online)
• Update notifications: Open Settings periodically to check for updates, or enable auto-update to be notified
• Multiple machines: Sign in with the same email on multiple computers to sync your preferences

---

Troubleshooting

”Session expired” message

This appears when your offline access period has ended. Connect to the internet and sign in again to refresh your access.

Sign in fails

1. Verify your email address is spelled correctly
2. Check your internet connection
3. Try again after a few moments
4. Contact support if the issue persists

Didn’t receive verification email

1. Check your spam or junk folder
2. Click Resend email in the verification dialog to send a new link
3. Verify your email address is correct (click Use different email to re-enter)
4. Some email providers may delay delivery. Wait a few minutes and check again

Verification link expired

Verification links expire after 15 minutes for security. Click Resend email in the dialog to receive a fresh link.

Update download stuck

1. Close the Settings dialog
2. Check your internet connection
3. Reopen Settings and try again
4. If issues persist, download manually from amorphous.dev

Settings not saving

Settings save automatically to %AppData%\Amorphous\config.json. If settings aren’t persisting:

1. Check that Revit has write access to your AppData folder
2. Try running Revit as administrator once to create the folder
3. Verify the folder exists: %AppData%\Amorphous\

---

Related

• Preferences - Configure tool-specific settings