Skip to main content

Get Details and Families into Your Revit Project (Pirros in Revit and Classic Plugin)

How to bring Details, sheets and Families from Pirros into your Revit Project, step by step for both plugin versions.


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 (docked panel). 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. Follow the matching section below. Not sure which one your firm should be on? See Pirros in Revit vs the Classic Plugin.

What's the same in both versions

  • Both pull from the same Pirros library and the same account.

  • Pirros upgrades Details and Families to the Revit version you have open.

  • Details can land under --PIRROS IMPORTS-- in your Project Browser: Pirros fills --PIRROS IMPORTS-- into the parameters your Project Browser organization groups views by, so the folder appears only if your organization groups by an editable parameter. To keep imported views out of it, clear Use Pirros Imports for View Sorting before you download (on the panel's Browse tab in Pirros in Revit, or at the bottom of the classic Download Items dialog). If the classic dialog doesn't show that checkbox, your classic plugin version doesn't have it and always sorts this way.

  • Each item carries a Pirros ID, which is how Pirros tracks the link between your copy and the library.

  • Downloading needs download permissions in your Pirros role: Download Project Details for project details, Download Typical Details for typical details, and Download Families for families. Items marked Reference Only need extra permission. Without permission to download details, both plugins show "You do not have permission to download details. Please contact your administrator to gain access to this feature."

  • When you download a whole stash, Pirros archives it afterwards, unless it's a firm stash or marked permanent.


Option A: Pirros in Revit (v4.x, docked panel)

1. Open the panel and sign in

  1. In Revit, click the Pirros tab in the ribbon.

  2. The panel docks to the right of your Revit window. Sign in with your Pirros account. You stay signed in when you restart Revit.

2. Link your project

Open Settings to link the active Revit Project to a Pirros Project: under Project, pick it in the Project list and click Link, or click New Project to create one and then click Link. Once linked, the Project name shows in the panel header. If you insert something before linking, the panel asks you to link a project (Link a project to download) and then carries on with your download. See Link Your Revit Project to Pirros.

3. Find what you need in Browse

Open the Browse tab. Search, then narrow results with the collapsible filter sections and the Sort button. Scroll to load more than the first 20 results.

4. Bring it into your model

  • Drag and drop: drag a result straight into your model.

  • Insert button: click Insert on the result. The button is on each result in list view; in grid view, click a result to open it and insert from there.

  • Several at once: in list view, check the results you want, then click Insert in the bar that appears (or drag one of the checked results). Families inserted this way load into your project without going on your cursor.

Details and sheets:

Sheets are shown by sheet number and name. Each detail and sheet also shows its project name and number, or Typical if it's a typical item. If a sheet's views are already in your project, Pirros asks before importing them again. When a detail or sheet you insert is already in your project, Some items already exist in this project opens: choose Skip, Replace existing or Keep both for each item (schedules offer Skip and Keep both), then click Apply. Every item starts on Skip.

Families:

  • A family with several types opens a type picker (Select types to import). Every type starts checked: uncheck the types you don't want, or use Select all or Deselect all to change every type at once. Every type you leave checked comes in. To choose which type lands on your cursor, click Place next to it (it then shows On cursor; the first type is chosen to start with), then click Import.

  • A single-type family places immediately.

  • If the family is already in your project, Insert and drag don't download it again: Pirros puts the family you already have on your cursor (if several of its types are loaded, pick one in Select type to place). To add types from Pirros to it, click the family to open its type list, check the types you want (none are checked to start with) and click Insert. See Avoid and Fix Duplicate Families.

  • Prevent duplicate families is a setting on the panel's Settings tab, and it's on by default. When a detail you insert (or a family nested inside a group) uses a family your project already has, Pirros reuses your project's family instead of loading another copy, so details may look slightly different. It doesn't apply to a family you insert directly.

5. Insert from a stash

Open a Stash in the panel and insert everything, or only the items you choose. On the Browse tab, open Stashes (use the User, Firm and Shared filters to see other stashes; only User is on to start with). Click Insert all on a stash to insert everything in it, or open the stash, check the items you want in list view and click Insert.

Staged on the website: anything you staged for download on the Pirros website can be brought in from the top of the Stashes tab: under Staged for download, click Download. With Live Link on (panel Settings tab, on by default), items you stage on the website, or send with the website's Insert button, are imported into the active model automatically. The website's button reads Insert when Pirros sees Revit connected with an open model, otherwise Stage for Download. If the model isn't linked to a project yet, Live Link shows Link a project to download. instead; link one in Settings, then click Download under Staged for download.

6. If something can't download

  • Items that can't be downloaded are greyed out with a message explaining why (hover over the item to see it).

  • If a download fails, the plugin says why and names the items that failed.

  • You can cancel a long-running download or insert. Pirros stops after the item it's working on, and anything already inserted stays in your model.


Option B: Classic plugin (v3.x)

1. Link your Revit project to Pirros

  1. In Revit, open the Pirros tab and click Settings, then Project Settings. If you see a Workspace field, choose the workspace first.

  2. If you are creating a new Project, click + New Project and enter a Project Name and Project Number, then click Create. The new Project is added to the list and selected; click Link to finish. If a Project with that number already exists in the workspace, the model is linked to that Project instead.

  3. If you are opening an existing Project, select it from the Project Dropdown, and click Link. Your firm's typical details library is listed first as Typical.

If you skip this step, Download asks you to link the model first (Project Link Required): click OK, link the Project in Project Settings, and the download continues.

2. Stage Details on the website

  1. On the Pirros website, open the Details page.

  2. Search or browse, then hover over each Detail and check its box.

  3. Click Insert in the orange bar at the top. This queues the Details for the plugin. The button reads Insert when Pirros sees Revit connected with an open model, and Stage for Download otherwise. While the classic Live Link button is connected (orange icon), the download starts in Revit automatically; otherwise continue with step 3.

You can also stage Families and Stashes on the website (Stage for Download, or Insert when Revit is connected).

3. Download in Revit

  1. In Revit, click the Pirros tab, then Download, and choose Download from the menu.

  2. Confirm the list in the Download Items dialog and click Confirm. Details are on the Details tab and Families on the Families tab (both tabs show when you download both). Details start selected; use Select All or Deselect All to change the rows shown. On the Families tab, check the types you want for each family. A Detail that's already in your project shows Already in project (or Name match found); choose Skip, Replace existing or Keep both under Resolution. It starts on Skip.

When the download is done, the progress window shows Finished; click OK. If some files fail to download, it says how many, and the files that did download are still imported. If nothing is staged, you'll see Nothing to download: stage items on the website first.

4. Handle duplicate families

If a Family you're downloading is already in your Project, the Families tab marks it Already in project, and each type your Project already has shows In project with an Action:

  • Link Existing: downloads nothing and links your Project's family to the Pirros family, so future updates track it.

  • Download New: loads the type from Pirros.

  • Skip: leaves your Project's type as it is. This is the default.

To set one action for every existing family at once, choose it in the list above the families and click Apply. If you don't see Apply, your classic plugin version doesn't have it; choose the action type by type.

If a Detail uses Families your Project already has, Prevent duplicate families (at the bottom of the dialog, ticked by default) reuses your Project's family instead of loading another copy. If you don't see that checkbox, your classic plugin version doesn't have it and always reuses your Project's family.


Side by side

Pirros in Revit (v4.x)

Classic plugin

Where you work

Docked panel, Browse tab

Website to stage, then ribbon Download and dialog

Get content into the model

Drag and drop, or Insert

Stage on the web, click Download, confirm

Multi-type Families

Type picker (Select types to import), all types checked to start; Select all / Deselect all

Per-type choices on the Families tab of Download Items

Duplicate Families

Prevent duplicate families setting (on by default); Skip / Replace existing / Keep my version per type

Link Existing / Download New / Skip per type; Prevent duplicate families checkbox

Link a Project

Settings, shown in panel header

Settings, then Project Settings: pick the Project (or + New Project), then Link

Revit versions

2024 and newer, once enabled for your firm

2020-2023, and 2024+ until your firm is enabled


Frequently Asked Questions

Q: Which plugin am I on?

A: The easiest way to tell is if you have multiple icons or a single icon in the upper left when clicking Pirros in the Revit ribbon. Pirros in Revit has a single Pirros icon, and the Legacy Plugin has Sync, Download, Settings, Pirros, and Live Link icons.
Pirros in Revit:

Legacy Plugin:

Q: I'm on Revit 2025 but see separate dialogs, not a panel. Is something wrong?

A: No. Pirros in Revit is enabled firm by firm. Your Pirros Administrator can ask us to enable it.

Q: Will downloaded content match my Revit version?

A: Yes. Pirros upgrades it to the version you have open.

Q: Do I need Revit to download a Detail?

A: Not for a PDF. Open the Detail and click Download PDF. Revit files need the plugin.

Q: Is the classic plugin going away?

A: No. It remains fully supported for Revit 2020 to 2023 and keeps receiving fixes.

Q: I clicked Pirros in Revit and nothing happened.

A: In the panel version, Revit can hold the panel in a hidden position. Follow the steps below:

Method 1: Keyboard Snap-to-Mouse (Autodesk Workaround)

  1. In Revit, click the Pirros icon in the ribbon once to focus the (invisible) pane.

  2. Press Alt + Spacebar.

  3. Press M (Move).

  4. Press any Arrow key once.

  5. Move your mouse; the Pirros pane should attach to your cursor and reappear.

  6. Click to drop it, then dock it to the left or right side of Revit.

Method 2: Reset Revit UI State

  1. Close Revit.

  2. Press Windows Key + R and open the following path: %APPDATA%\Autodesk\Revit\Autodesk Revit 2025\ENU.

  3. Delete the UIState.dat file (Revit will recreate it on launch).

  4. Reopen Revit and click the Pirros tab to load the pane in its default position.

Method 3: Toggle the Add-In in Add-Ins Manager

  1. In Revit, navigate to Manage > Add-Ins Manager.

  2. Uncheck the Pirros Plugin, then click Apply and close Revit.

  3. Reopen Revit, return to Manage > Add-Ins Manager, and check the Pirros Plugin.

  4. Click Apply, close Revit, and reopen it. The Pirros pane should now appear on the right side.

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

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

Docking the Pirros Plugin Pane

To dock the Pirros plugin pane to the left side of the Revit interface:

  1. Drag the Pirros plugin pane toward the left toolbar.

  2. Wait until the left docking indicator appears.

  3. Release the pane to dock it. This will create an additional tab in the left panel, visible at the bottom of the panel.

Did this answer your question?