Skip to main content

Troubleshooting the Pirros Revit Plugin by Version (Pirros in Revit and Classic Plugin)

Fixes for common Pirros plugin problems, split by plugin version: Pirros in Revit (docked panel) and the classic plugin.


Pirros has two plugin generations, and the symptoms and fixes differ. This guide covers problems by plugin version. For the general reinstall steps that apply to both, see the Pirros-Revit Troubleshooting Guide.

Step 1: Find out which plugin you have

Which plugin do 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.

To find your version number:

  • Pirros in Revit: open the panel's Settings tab. The Plugin line near the bottom shows your version number.

  • Classic plugin: click Settings, then About. The window shows your Version.

Can't open Settings because the panel won't load? A panel that opens beside your model means v4. Separate dialog windows mean classic. To read the installed version without opening Pirros, go to Windows Settings › Apps (or Control Panel › Programs and Features) and find Pirros Revit Plugin (publisher Pirros Inc). A 3.x version means the classic plugin on every Revit version. A 4.0.x version means Pirros in Revit on Revit 2024–2027 and the classic plugin on Revit 2020–2023.

Step 2: Try the fixes that apply to both

  1. Update the plugin. Check your version (see Step 1) and install the latest from app.pirros.com/plugin. Classic plugin: to keep it updated automatically, click Settings, then About, and tick Auto-update. 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 Revit completely and reopen it.

  3. Check your connection. The plugin needs internet access. If your firm uses a proxy or firewall, see Network Requirements: Domains to Allow Through Your Proxy, PAC File, or Firewall.

  4. Rule out another add-in. Other add-ins can interfere with Pirros, and Revit may switch Pirros off or stop it connecting. Temporarily disable your other add-ins, then re-enable them one or two at a time to find the one causing the conflict. Update that add-in if a newer version is available.

  5. Do a clean reinstall. Follow the full reinstall steps in the Pirros-Revit Troubleshooting Guide. Installing over the top of an existing version isn't the same as a clean removal.


Pirros in Revit (v4.x): docked panel problems

I click the Pirros button and nothing happens, or I can't see the panel

Revit may think the panel is already open but have it positioned somewhere you can't see, for example after a monitor or resolution change. Clicking the button then just hides and shows that invisible panel.

  1. Look for the panel as a thin collapsed strip along a screen edge, or as a small tab next to the Project Browser, and drag it into view.

  2. If you recently disconnected a second monitor, reconnect the old setup. The panel may reappear.

  3. If that doesn't work, reset Revit's saved panel layout:

    1. Close Revit. Open Task Manager, go to the Details tab, and end every Revit.exe. A copy left running can write the old layout back.

    2. Press Win+R, paste %APPDATA%\Autodesk\Revit\Autodesk Revit {YEAR} (use your Revit year), and press Enter.

    3. Rename RevitUILayout.xml to RevitUILayout.xml.old.

    4. Start Revit and open any project. The panel opens by itself after roughly 10 seconds. Don't click the Pirros button while you wait, because it can hide the panel again.

    5. Sign in on the panel with your usual Pirros email and password.
      ​NOTE: (This also resets Revit's other panels, such as Properties and the Project Browser, to their default positions.)

  4. If the above doesn't work either, reset the plugin:

    1. In Revit, click Manage > Add-Ins Manager > uncheck Pirros Plugin > click Apply > click Close > close Revit.

    2. Reopen Revit > click Manage > Add-Ins Manager > check Pirros Plugin > click Apply > click Close > close Revit.

    3. Reopen Revit, and the Pirros pane opens on the right side of the Revit window.

There's no Pirros button in Revit 2024–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. Check the add-in folders for your Revit year: C:\ProgramData\Autodesk\Revit\Addins\{YEAR} (for Revit 2027: C:\Program Files\Autodesk\Revit\Addins\2027) and %APPDATA%\Autodesk\Revit\Addins\{YEAR}. Pirros in Revit uses Pirros.Plugin.Revit.addin and a PirrosPlugin folder. If you also find the classic plugin's Pirros.addin and Pirros folder for the same year, do a clean reinstall (Step 2). If the files are right and the button is still missing, send your plugin log to Pirros support (see What to send Pirros support below).

The panel spins for several minutes, or never connects to Revit

First, click the Refresh button at the top right of the panel. It reloads the whole panel and reconnects it to Revit.

This is most often another add-in supplying an older copy of a component the panel depends on. Disable your other add-ins and test, as in Step 2. If Settings shows no version number or says to update the plugin even though you're current, that points to the same cause. If you also use Mira, include it in that test: Mira shares some components with Pirros in Revit, and Revit uses the copy from whichever add-in loads first.

The panel is blank or won't load

Ask IT to check that Pirros domains are allowed through your proxy or firewall. See Network Requirements. Then update to the latest plugin, which includes loading reliability fixes.

If the panel shows Something Went Wrong..., click Try again.

The panel opens on the wrong page, or the sign-in window closes early

Update the plugin. Both were fixed in 4.0.55, and staying signed in after a Revit restart arrived in 4.0.60.

To sign in again from scratch, click Sign out on the panel's Settings tab, then sign in on the panel. Signing out ends your Pirros session in every Revit you have open.

"Execution timeout exceeded" when I insert a family

Revit won't start loading a new family until the previous placement is finished. If you click Insert on a second family while another is still being placed, the panel can time out. The first family usually still loads. Finish placing the first one, or press Esc, before inserting the next.

"Revit took longer than 100 seconds to answer" (or "Execution timeout exceeded") when I insert

If Revit is busy for more than 100 seconds, the panel stops waiting and shows: Revit took longer than 100 seconds to answer, so the pane stopped waiting. Revit may still be working on it — close any open Revit dialog, and check the result before you try again. A few actions can still show the older message Execution timeout exceeded. In both cases Revit may still finish the job, so close any open Revit dialog and check your model before you try again.

From plugin 4.0.102, the panel keeps following a long import instead of giving up at 100 seconds. Older versions show "[item name]" was still loading after 100 seconds, so the pane stopped waiting for it. Revit may still finish it — check the model before you insert it again.

Revit won't start loading a new family until the previous placement is finished. While an insert or placement is running, the results list is dimmed and can't be clicked. If you start dragging another item while a family is still being placed, the panel shows Already placing "[family name]". Finish or press Escape in Revit before dragging again. Finish placing the first one, or press Esc, before inserting the next.

Several Revit sessions are open

Multiple concurrent Revit sessions are supported from 4.0.39, and Live Link actions go to the correct session from 4.0.73. Update if you see actions land in the wrong session.

Live Link is the Live Link switch on the panel's Settings tab (Auto-import items into the active model when you stage them for download on the web.). It's on by default. While it's off, items you stage on the Pirros website aren't imported automatically. When several Revit sessions are open, only the active one imports them.


Classic plugin (v3.x): ribbon and dialog problems

The Pirros tab or add-in is missing in one Revit year

  1. Check that Pirros.addin and the Pirros folder exist in C:\ProgramData\Autodesk\Revit\Addins\{YEAR} for that year (for Revit 2027: C:\Program Files\Autodesk\Revit\Addins\2027).

  2. Open Revit's add-in manager and confirm Pirros is enabled (the classic plugin's add-in is named Pirros Addin). After toggling it, close and reopen Revit.

  3. If you've reinstalled and it's still missing for that one year, run the add-in conflict test in Step 2, then do a clean removal and reinstall. Uninstalling removes Pirros from every Revit year at once, and the installer puts it back for every year.

A download looks successful but the detail is missing or wrong

Confirm you're on 3.2.5 or later, try the download again, and reinstall if it persists.

In the Download Items window, a detail that's already in your project (Status Already in project or Name match found) is set to Skip by default, which leaves the view in your model unchanged. To bring in the Pirros version, choose Replace existing or Keep both in its Resolution column before you click Confirm. Family types already in your project are also set to Skip; choose Link Existing or Download New in the Action column. If everything was skipped, the download ends with All items were skipped.

Revit slows down or crashes while Live Link is on

Update to the latest classic plugin. If you can't update yet, the Live Link icon in the plugin can be switched off. When it's orange, click it and it turns grey, which disables Live Link.

Live Link stays off only until you close Revit; it's on again the next time Revit starts. To turn it back on sooner, click the icon again. If you're signed out, clicking it opens the sign-in window instead.

"Project Link Required"

Sync, Download and Download Latest show This Revit model hasn't been linked to Pirros yet. On the next prompt, please provide the name and project number that this active Revit model is associated with. when the model isn't linked to a Pirros project. Click OK. In the Project Settings window, pick the project in the Project list (or create one with + New Project) and click Link. The command you started then carries on. See Link Your Revit Project to Pirros (Pirros in Revit and Classic Plugin).

"Connection Timeout"

Unable to connect to Pirros. Please check your internet connection and try again. appears when Pirros doesn't answer within 15 seconds while a command is starting. Check your internet connection, and if your firm uses a proxy or firewall, see Step 2.

"Nothing to download"

If Download shows Nothing to download and Your stash is empty. Add items from the Pirros website to download them here., nothing is waiting to be downloaded. On the Pirros website, click Stage for Download (or Insert) on what you want, then click Download in Revit again. Pirros leaves out staged items saved in a newer Revit version than yours, or that your role can't download, and the classic plugin doesn't list them.

"Permission Denied"

You do not have permission to download details. Please contact your administrator to gain access to this feature. means your role has none of the Download Project Details, Download Typical Details or Download Reference Only permissions. You do not have permission to sync project details. Please contact your administrator to gain access to this feature. (or …sync typical details…) means your role doesn't have both Create Details and Edit Details (for the Typical project: Create Typical Details and Edit Typical Details). Ask your Pirros admin for access. Pirros in Revit shows the same messages in the panel.

"Update Detected"

Warning: Update Detected / Pirros may not function correctly until you restart Revit. appears when the installed plugin version is different from the one running in Revit. Close Revit completely and reopen it.

Sign-in problems

Click Settings, then Login. A separate Authenticating... window opens and always asks for your credentials; when it works you see Successfully Logged In. Closing that window cancels the sign-in. The classic plugin has no sign-out command: signing in again with Login replaces the saved sign-in.

Download Latest says "You're all synced up!"

With All your Pirros content is current., none of the Pirros content it checked has a newer version (the window shows how many details and families it checked). With No Pirros content found in this document., the model has no Pirros-tracked content to check.


What to send Pirros support

  • Your Revit version and your plugin version, if you can read it.

  • The exact error text or a screenshot.

  • What you were doing when it happened.

  • What you've already tried, such as a reinstall or disabling other add-ins.

  • Your plugin log files. Both versions write them to %LOCALAPPDATA%\Pirros\logs (Pirros in Revit: PirrosWebRevitPlugin-<date>.log; classic plugin: <date>.log). Some panel messages mention %LocalAppData%/Pirros/debug.log; send the files from the logs folder instead.

To find the logs from inside Revit:

  • Pirros in Revit: on the panel's Settings tab, hold Ctrl+Alt and click the Pirros logo. A Diagnostics box appears. Open log folder opens the logs folder, and Copy copies your plugin version, Revit version, Revit user name and log folder so you can paste them into your message.

  • Classic plugin: click Settings, then About, then hold Ctrl+Alt and click the Pirros logo. The Pirros Diagnostics window opens. Its Log tab shows the current log, and its Information tab has Copy To Clipboard.

Contact support through the in-app chat or [email protected].

Did this answer your question?