For BIM managers. End-user workflows: see Work with Revit in Guides.
Requirements
- Autodesk Revit 2020–2027 (installer components Revit20–Revit27, side-by-side)
- Administrative access to install add-ins
- 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.
Silent install for IT deployment:
HyparRevit.exe /VERYSILENT /COMPONENTS="Revit25" /LOG="HyparRevit.log"
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 |
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).