Prerequisite: You need admin-level access to your computer to perform most of these steps. If you do not have admin access, work with your IT department.
If you encounter errors in the Pirros Revit plugin — failed downloads, sync issues, or the plugin not appearing — follow this guide to resolve them. Start with the quick fixes, then move to the full reinstall if needed.
Quick Fixes (Try These First)
1. Update the plugin to the latest version.
Many issues are resolved by simply updating. Check which plugin and version you have (see the FAQ below), then download the latest installer from app.pirros.com/plugin and run it. Classic plugin: in Revit, go to the Pirros tab, click Settings then About, and enable Auto-update if it is not already checked. Pirros in Revit has no auto-update setting in the panel; its updates install in the background on a schedule when Revit is closed.
2. Close and reopen Revit.
Some issues are caused by stale plugin state. Close all Revit windows and dialog boxes completely, then reopen Revit.
3. Check your internet connection.
The plugin requires an active internet connection to sync, download, and upload. Verify you can reach app.pirros.com in your browser.
4. Refresh the panel (Pirros in Revit).
Click the Refresh button at the top right of the Pirros panel. It reloads the whole panel and reconnects it to Revit. For more panel problems, see Troubleshooting the Pirros Revit Plugin by Version.
Full Reinstall
If quick fixes do not resolve the issue, perform a clean reinstall:
Close all instances of Revit. Make sure no Revit processes are running in the background (check Task Manager if needed).
Uninstall the Pirros plugin:
Open Control Panel > Programs > Programs and Features.
Search for Pirros Revit Plugin.
Click the entry and click Uninstall.
The same entry (publisher Pirros Inc) is used for Pirros in Revit and the classic plugin, and uninstalling it removes Pirros from every Revit year at once.
Remove lingering plugin files. Check these locations on your machine and delete any Pirros add-in files you find in each: the Pirros.Plugin.Revit.addin file and PirrosPlugin folder (Pirros in Revit), and the Pirros folder and Pirros.addin file (classic plugin):
C:\ProgramData\Autodesk\Revit\Addins\{YEAR}(Revit 2020–2026)C:\Program Files\Autodesk\Revit\Addins\2027(Revit 2027)C:\Users\{USER}\AppData\Roaming\Autodesk\Revit\Addins\{YEAR}
The plugin installs for Revit years 2020 through 2027, so check each year folder.
Uninstalling doesn't remove your own Pirros files in
%LOCALAPPDATA%\Pirros, such as the plugin logs and saved sign-in data.Reinstall the plugin. Download the latest version from app.pirros.com/plugin and run the installer.
Open Revit and verify the Pirros tab appears in the ribbon. With Pirros in Revit (Revit 2024–2027, once it's enabled for your firm), the tab has a single Pirros button that opens the Pirros panel. With the classic plugin, it has Sync, Download, Settings, Pirros and Live Link buttons.
Common Issues
Plugin not appearing in Revit after installation
Verify Revit was fully closed during installation.
Check that the add-in file exists in the correct Addins folder for your Revit version: Pirros.Plugin.Revit.addin for Pirros in Revit, Pirros.addin for the classic plugin. Revit 2027 add-ins are in
C:\Program Files\Autodesk\Revit\Addins\2027.If Pirros in Revit and the classic plugin are both registered for the same Revit year, only one of them can create the Pirros ribbon panel, so the other one's buttons don't appear. If you find both add-in files for one year, do the full reinstall above.
If your firm uses antivirus or endpoint protection, check that it has not quarantined the plugin files.
The Pirros panel is blank, spins, or won't connect (Pirros in Revit)
Click Refresh at the top right of the panel, then see Troubleshooting the Pirros Revit Plugin by Version for panel-specific fixes.
Duplicate details appearing after sync
This typically happens when the model's project assignment has changed. See the article "Understanding How Syncing Works" for details on why this occurs and how to avoid it.
Sync fails with an error message
Copy the exact error message and check for a matching entry in the Troubleshooting Upload & Sync Errors article.
If the error is not listed, contact Pirros support via the in-app chat with the error message and your plugin version number.
Download appears to succeed but the detail is missing or incorrect in Revit
Verify you are on the latest plugin version (minimum 3.2.5 or later).
Try downloading the detail again. If the issue persists, uninstall and reinstall using the full reinstall steps above.
Classic plugin: in the Download Items window, details already in your project are set to Skip by default, which leaves your existing view unchanged. Choose Replace existing or Keep both in the Resolution column to bring in the Pirros version. Family types already in your project are also set to Skip; choose Link Existing or Download New in the Action column.
How to Report an Issue
If none of the above resolves your problem:
Note your plugin version (Pirros in Revit: the Plugin line near the bottom of the panel's Settings tab; classic plugin: Pirros tab > Settings > About).
Note the exact error message (screenshot if possible).
Note what you were doing when the error occurred (syncing, downloading, uploading, etc.).
Collect your plugin log files from
%LOCALAPPDATA%\Pirros\logs. In Pirros in Revit, hold Ctrl+Alt and click the Pirros logo on the panel's Settings tab, then click Open log folder. In the classic plugin, hold Ctrl+Alt and click the Pirros logo in Settings > About to open Pirros Diagnostics; its Log tab shows the current log.Contact Pirros support via the in-app chat (purple speech bubble in the bottom-right of the Pirros web app) or email [email protected].
FAQ
Q: How do I know what version of the plugin I am running?
A: First check which plugin you have. Look at the Pirros tab in the Revit ribbon. A single Pirros button that opens a docked panel with Browse, Updates, Sync and Settings tabs means you have Pirros in Revit. Separate Sync, Download, Settings, Pirros and Live Link buttons mean you have the classic plugin. Don't go by the version number alone: on Revit 2020–2023 the classic plugin can show a 4.x version number.
Pirros in Revit: open the panel's Settings tab. The Plugin line near the bottom shows the version number.
Classic plugin: click the Pirros tab, then Settings → About. The window shows the Version.
If Pirros won't open: in Windows Settings → Apps (or Control Panel → Programs and Features), find Pirros Revit Plugin. A 3.x version means the classic plugin on every Revit version; 4.0.x means Pirros in Revit on Revit 2024–2027 and the classic plugin on Revit 2020–2023.
Q: Do I need to reinstall the plugin for every Revit version?
A: No. The installer handles all supported Revit versions (2020–2027) in a single installation.
Q: The plugin was working yesterday but not today. What changed?
A: Check if your firm deployed a Windows or Revit update overnight. Also check if your antivirus quarantined plugin files. Try the quick fixes first, then the full reinstall if needed.
Q: My firm manages plugin installations centrally through IT. What should I do?
A: Ask your IT team to deploy the latest plugin version using the remote installation commands documented in the "How to Install or Uninstall the Pirros Plugin Remotely" article.