Settings & Configuration

The Settings window is the central place to configure the add-in's connection, export preferences, and advanced options.

Open it by clicking Settings in the Alpha ribbon's Preferences panel.

Settings Window Fields

Field	Description
Environment	Select `dev`, `accept`, or `production`
Dev API Key	API key for the development environment
Accept API Key	API key for the acceptance/staging environment
Production API Key	API key for the production environment

Field	Description
Type ID	The Alpha product type to work with (used by Missing Coverage, Static Names, and other tools)
Tenant ID	Your organization's tenant identifier
Project ID	The Alpha project to associate exports with
House ID	The specific house/unit identifier
Client ID	The client identifier for scoped operations

Toggle which output formats are generated during export:

Toggle	Default	Description
Upload Outputs	On	Automatically upload exported files to the Alpha platform

When disabled, files are saved locally only.

Field	Default	Description
Exporter Output	`%UserProfile%\Alpha\exports\`	Where exported model files are saved
Configurator Output	`%UserProfile%\Alpha\output\`	Where configuration output files are saved
Resource Directory	`%UserProfile%\Alpha\resources\`	Where downloaded resources are cached

Field	Description
Developer Mode	Enables additional logging and diagnostic features
Export Template Path	Path to a custom Revit template file used during export
Configuration Template Path	Path to a custom configuration template

Settings are stored as JSON at:

%UserProfile%\Alpha\settings.json

For example:

C:\Users\YourName\Alpha\settings.json

The add-in watches this file for changes. If you edit it externally, the add-in picks up the new values automatically.

The Preferences panel in the ribbon also provides quick-access buttons:

Button	Action
Console	Opens a live log window showing real-time add-in messages. Useful for monitoring export progress or diagnosing issues.
Log	Opens the current session's log file in your default text editor. Share this file with support when reporting issues.
Settings File	Opens `settings.json` directly in your default text editor for manual editing.