For BIM managers. End-user workflows: see Work with Revit in Guides.

Requirements

Autodesk Revit 2020–2027 (installer components Revit20–Revit27, side-by-side)

No administrator rights required. The add-in installs per-user, into your own %APPDATA%.

Any Hypar account (free accounts include the add-in)

Installation

Get HyparRevit.exe from the Export to Revit / Import from Revit dialogs in Hypar. Choose all Revit versions or specific ones.

HyparRevit.exe runs in the user context, installing to %APPDATA%\Autodesk\Revit\Addins\[Year]. It cannot be redirected to install somewhere else. Don't run it as SYSTEM, this will install it as the “SYSTEM” user, not for all users. We don’t currently suport installing system wide via C:\ProgramData\.

Silent install for IT deployment:

javascript
HyparRevit.exe /VERYSILENT /SUPPRESSMSGBOXES /COMPONENTS="Revit25" /LOG="%TEMP%\HyparRevit.log"

💡

Close Revit before installing.

If Revit is running, Setup waits for it to exit. Under /`VERYSILENT` it waits indefinitely with no visible window, so scripted deployments should confirm Revit is closed first.

Location	Path
Add-in registration + DLLs	`%APPDATA%\Autodesk\Revit\Addins\[VERSION]\`
Toolbar config	`%USERPROFILE%\.hypar\addin-config\addin-config.json`
Settings	`%USERPROFILE%\.hypar\revit-settings.json`
Custom converters	`%USERPROFILE%\.hypar\converters\revit\*.dll`
Log	`%USERPROFILE%\.hypar\hypar-revit.log`

The add-in checks for a newer release when Revit starts. If the user accepts, it will install when Revit closes, as a visible installer window rather than a silent install. You can edit the %USERPROFILE%\.hypar\revit-settings.json to override this by setting "UpdateOption": "Never"

💡

Note that if an installed version falls below our minimum supported version, users won’t be able to load the add-in. You should do a periodic refresh of your deployed package.

Enterprise Deployment:

Deploy per-user in the user context. No elevation needed. Each user signs into their own Hypar account. Credentials, settings, and converters live in %USERPROFILE%\.hypar and are resolved when Revit starts, so there's no shared state to centralize. Machine-wide deployment via ProgramData isn't currently supported.

Account connection

First use opens a browser to sign in at hypar.io; a pairing code shows in both Revit and the browser, and users verify they match and confirm. Connection persists across sessions. Sign-out is at the bottom of the Settings dialog.

Toolbar

The Add-Ins tab shows up to five commands: Send Selection to Hypar, Convert All, Convert View, Load Project, Settings. Customize via addin-config.json (ToolbarOverrides): rename the ribbon label, per-button text/icons (16×16 and 32×32), or Hide buttons. Button keys: HyparConvertAll, HyparConvertView, GlbContentFromMultiple, Settings.

Settings dialog

Persisted to revit-settings.json:

Converter table: enable/disable each converter, with From Hypar / To Hypar direction columns

EnableDefaultConverter (default off): import Hypar elements as generic geometry when no converter exists

AllowAddingParameters (default on): writes Hypar shared parameters (element IDs, space-program data) onto imported elements

CustomRoomParameterMapping (default off): map Hypar space properties to custom Revit room parameters

UpdateOption: Ask / Always / Never for add-in updates

Custom converters

Developers can implement IRevitConverter (from the Elements.Conversion.Revit NuGet package) or extend BaseRevitConverter. Target netstandard2.0 for Revit 2020–2024, net8.0-windows for 2025+. Drop the DLL in %USERPROFILE%\.hypar\converters\revit\ and restart Revit; converters are auto-discovered. Samples: hypar-io/Revit SampleConverters/.

Troubleshooting

Symptom	Fix
Toolbar missing	Check the .addin file under `%APPDATA%\Autodesk\Revit\Addins\[VERSION]\`; reinstall that version component; rerun installer with /LOG
Auth browser doesn't open	Check firewall/proxy; sign in at hypar.io manually first
Pairing codes don't match	Close the browser window and redo the flow
Connection drops	Allow WebSocket traffic to `wss://prod-live.hypar.io/Prod` (both apps must be running)
Missing families on load	Resolve or substitute when prompted
Columns/floors missing after load	Update the add-in (support added 2026)
Elements not converting	Confirm converter DLL present; check hypar-revit.log and include it in support reports

Last verified against Hypar v0.2.019 (July 10, 2026).

Revit add-in: deployment and configuration