What this article covers: installing the Pirros Revit plugin — your firm's detail and family library inside Revit.
This article is not about Mira. Mira is a separate product with its own installer from mira.pirros.com. Nothing on this page applies to Mira. In particular, if Mira is asking you to allow a permission (for example Allow CreateDynamicTool), that is a prompt inside the Mira chat panel — it is not a Windows prompt, it does not require administrator rights, and you do not need to contact IT. Just click Allow. See Mira Tool Permissions: What the "Allow" Prompts Mean.
Prerequisite: You need administrator-level access to your computer to run the plugin installer. If you do not have admin access, contact your IT department before proceeding. This applies to installing and updating the plugin only — it is not needed to use Pirros or Mira day to day.
The Pirros Revit plugin connects Revit directly to your Pirros library. With the plugin, you can download details and families from Pirros into your active Revit project, sync changes back, and upload new content — all without leaving Revit.
Two plugin generations exist. Revit 2024 and newer receive Pirros in Revit — your full library as a dockable panel. Revit 2023 and older use the classic plugin. The download and installation steps below are the same either way; the installer gives each Revit version on your machine the right one. See Pirros in Revit vs the Classic Plugin: Which One Do I Have?
Download the Plugin
Go directly to the download page: app.pirros.com/plugin, or find it from within Pirros:
Click the dropdown arrow next to your Workspace in the top-left corner of the Pirros web app.
Click Revit Plugin.
Click Download.
Install the Plugin
Close all instances of Revit — including any open dialog boxes or background processes.
Navigate to your Downloads folder and run the installer (.msi file).
Follow the on-screen instructions to complete the installation.
Verify the Installation
Open Revit.
Look for the Pirros tab in the top navigation ribbon.
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.
NOTE: Don't go by the version number alone: on Revit 2020–2023 the classic plugin can show a 4.x version number.
In Pirros in Revit, click the Pirros button to open the panel. The panel opens docked to the side of the Revit window. Click the button again to hide it.
Update the Plugin
The plugin updates itself automatically. A scheduled Windows task checks for a new version once a day overnight and again shortly after Windows starts, and installs it in the background — your Windows account doesn't need administrator rights for this. Updates only install while Revit is closed: if Revit is open when the check runs, the update waits for the next check.
To check which version you're on, or to change the auto-update setting:
Pirros in Revit: open the panel and go to the Settings tab. The Plugin line near the bottom shows your version. There's no auto-update setting in the panel — updates install in the background as described above.
Classic plugin:
In Revit, click the Pirros tab.
Click Settings then About.
Check the Auto-update checkbox to ensure future updates install automatically. The setting applies to everyone who uses the computer.
The About Pirros window also shows your Version. When a newer version is available for your firm, its update button reads Update Available — click it to schedule the update. The update installs the next time the scheduled update runs while Revit is closed.
With either plugin, you can also update by hand at any time: download the installer from app.pirros.com/plugin and run it. It replaces the version you have, so there's no need to uninstall first.
If auto-update is not available (for example, because your IT department manages installations centrally), ask your IT team to deploy the latest version. See the article on remote installation for IT-managed deployments.
New versions roll out in stages. Pirros releases each new plugin version to firms gradually, not to everyone at once. A version listed in the Plug-in Release Notes may not be available to your firm yet — the version your firm receives (through both auto-update and the download page) is the one currently assigned to your firm, so neither will move you ahead of the rollout. This is expected. To get your whole firm onto the newest version right away, contact Pirros support or your CSM and we can enable it for you.
FAQ
Q: Which Revit versions does the plugin support?
A: The plugin supports Revit 2020 through 2027. It installs for all supported versions automatically. For the authoritative per-version breakdown — including which versions get Pirros in Revit versus the classic plugin, and what Revit 2020 can and cannot do — see the Revit Version Compatibility Matrix.
Q: Will I get Pirros in Revit or the classic plugin?
A: It depends on your Revit version. Revit 2024 and newer get Pirros in Revit — the docked panel — as it is enabled for your firm; until then, they use the classic plugin. Revit 2023 and older use the classic plugin. You don't choose; the installer sets up the right one for each Revit version on your machine. See Pirros in Revit vs the Classic Plugin: Which One Do I Have?
Q: Is Mira installed with this plugin?
A: No. Mira is a separate product with a separate installer, downloaded from mira.pirros.com. Installing the Pirros plugin does not install Mira, and installing Mira does not install the Pirros plugin. You can run both at the same time. See Meet Mira: The AI Agent for Revit.
Q: Do I need to uninstall the old version before updating?
A: No. The installer handles upgrades automatically. If you encounter issues after an update, see the Pirros-Revit Troubleshooting Guide.
Q: Which version is installed on my computer?
A: Follow the steps under Update the Plugin above. If Pirros won't open, look in Windows Settings → Apps (or Control Panel → Programs and Features) for 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.
Q: The release notes show a newer version than the one I have. Why don't I have it yet?
A: Pirros rolls out new plugin versions to firms in stages, so a version in the release notes won't reach every firm on the same day. Until your firm is assigned the newer version, auto-update and the download page keep serving your firm's current version — they won't jump ahead of the rollout. If you need the newest version right away, contact Pirros support or your CSM and we can enable it for your firm.
Q: The Pirros tab does not appear in Revit after installation. What should I do?
A: Close Revit completely and reopen it. If the tab still does not appear, verify the installation completed without errors — Pirros Revit Plugin (publisher Pirros Inc) should be listed in Windows Settings → Apps — and that no antivirus software blocked the plugin files. If the issue persists, follow the steps in the Troubleshooting Guide.
Q: Can the plugin be installed on a Mac?
A: No. The Pirros Revit plugin requires Windows because Revit itself is a Windows-only application.
Q: Can my IT team deploy the plugin across all machines remotely?
A: Yes. See the article "How to Install or Uninstall the Pirros Plugin Remotely" for command-line installation instructions.