Skip to main content

Link Your Revit Project to Pirros (Pirros in Revit and Classic Plugin)

How to link your open Revit model to a Pirros 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. 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. See Pirros in Revit vs the Classic Plugin for the differences.

Why you link a project

Linking tells Pirros which Pirros project your open Revit model belongs to. Content you download is recorded against that project, and content you sync goes to it. Link your model before you download or sync for the first time.

The link is saved in the Revit model itself, and both plugins read the same link, so a model you linked with the classic plugin stays linked in Pirros in Revit.

What's the same in both versions

  • A model links to one Pirros project at a time. To use a different project, change the link first.

  • Pirros matches projects by project number in your current workspace: when you create a project from the plugin and a Pirros project with that number already exists, your model links to it. If not, Pirros creates it.

  • If the model's Project Number in Revit's Project Information matches a Pirros project, that project is selected for you; you still click Link.

  • Your firm's typical details library is listed first as Typical. Syncing to Typical needs the Create Typical Details and Edit Typical Details permissions.

  • Don't change the project on a model that has already been synced unless you mean to re-upload everything. Pirros treats every detail as a new upload under the new project, which creates duplicates.

  • Working with several near-identical models, such as a campus? Link all of them to the same Pirros project. See Keeping Multiple Building Models in Sync with Pirros.


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

  1. On the Pirros tab in the Revit ribbon, click the Pirros button and sign in to the panel.

  2. Open Settings in the panel. The Project section is at the top.

  3. Link the project: if you see a Workspace list, choose the workspace first. Pick your project in the Project list (you can type to search; projects show as name | number), then click Link.

Once linked, the project name shows in the panel header, so you can always see where your model is pointing. Under the Project list, Currently linked: shows the current link, or No project linked yet.

Create a project: click New Project, enter the Project Name and Project Number, and click Create. The project is selected in the list; click Link to finish. If that project number already exists in the workspace, Pirros selects the existing project instead and tells you so (Linked to existing project); click Link to finish. If you don't see New Project, your role doesn't have the permissions for it; ask your Pirros administrator.

Change the link: pick another project and click Link. There's no confirmation step. If the linked project no longer exists in Pirros, Settings shows The linked project is no longer available in Pirros. Pick another project or create one to continue. with a Clear link button.

Linking mid-download: if you insert or download into a model that isn't linked, the panel opens Link a project to download with the same project list. Link a project and your download carries on automatically, or click Cancel download. Live Link imports don't open this window; they show Link a project to download. instead.


Option B: Classic plugin (v3.x)

  1. In Revit, open the Pirros tab and click Settings, then Project Settings. If you aren't signed in, the sign-in window opens first.

  2. If you see a Workspace field, choose the workspace.

  3. Pick the project in the Project list (type to search by name or number). Your firm's typical details library is listed first as Typical.

  4. To create a project instead, click + New Project, enter the Project Name and Project Number, and click Create. The project is added to the list and selected.

  5. Click Link. Nothing is created or linked in Pirros until you do.

Linking to Typical: needs the Create Typical Details or Edit Typical Details permission. Without it, you'll see Unable to link project to Pirros: followed by the reason.

Linking mid-download: Download, Download Latest and Sync check the link first. If the model isn't linked, you'll see Project Link Required: click OK, link the project in Project Settings, and the command continues.

To upload (sync) content from a model: link it the same way. Syncing also needs sync permissions, which only Admins have by default. See Sync Content from Revit to Pirros.

To see what's linked, open Settings, then Project Settings: the linked project is selected in the Project list.


Side by side


​Pirros in Revit (v4.x)

Classic plugin

Where

Settings tab in the panel

Settings, then Project Settings

What you enter

Pick a project (or Typical) and click Link; New Project asks for Project Name and Project Number

Pick a project (or Typical) and click Link; + New Project asks for Project Name and Project Number

Matched by

Project number, in your current workspace

Project number, in your current workspace

See what's linked

Project name in the panel header

Settings, then Project Settings

Linking mid-download

Prompted, then the download continues

Prompted (Project Link Required), then the download continues


Frequently Asked Questions

Q: Do I have to link a project before I download?

A: Yes, link before your first download so Pirros knows which project the content belongs to. If you haven't, both plugins ask you to link one when you start the download.

Q: Can one model link to more than one project?

A: Not at the same time. To upload to a different project, change the link first.

Q: I changed the linked project and now I see duplicates. Why?

A: Pirros treats every detail as a new upload under the new project. Change the project on a synced model only when you intend to re-upload.

Q: What is Typical Details?

A: It's your firm's vetted standard library, as opposed to details tied to a single project. In the project list it appears as Typical.

Q: How do I confirm my plugin version?

A: In Pirros in Revit, open the panel's Settings tab; the Plugin line near the bottom shows the version. In the classic plugin, click Settings, then About. If Pirros won't open, check Pirros Revit Plugin in Windows Settings → Apps (or Control Panel → Programs and Features): 3.x is the classic plugin on every Revit version; 4.0.x is Pirros in Revit on Revit 2024–2027 and the classic plugin on Revit 2020–2023. Don't use the version number alone to tell the plugins apart.

Did this answer your question?