Skip to main content

How to Remove the Pirros Parameters from Your Revit Model

Clean up Pirros-specific parameters when preparing models for delivery or archival — steps for Pirros in Revit (v4.x) and the classic plugin (v3.x).

The Pirros plugin adds two shared parameters, PirrosID and PirrosInSync, to the views, sheets and schedules of every Revit project you open or create while it's installed — not only when you download Details from Pirros. These parameters are used by the Pirros plugin to track versioning and sync status.

Before delivering a model to a client or archiving it, you may want to remove these parameters.

Prerequisite: You need edit access to the Revit model. This is a model-level change, so coordinate with your team before proceeding.

Don't delete the parameters by hand in Revit — the plugin adds them back the next time the model is opened. The steps below remove them and stop them from being added again.

The steps depend on which plugin generation you have: Pirros in Revit or the classic plugin. Not sure which one you're running? See Pirros in Revit vs the Classic Plugin.

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.

How to Remove Parameters in Pirros in Revit (v4.x)

  1. Open the Revit model that contains Pirros-downloaded details

  2. Click Pirros on the ribbon to open the Pirros panel

  3. Go to the Settings tab

  4. Scroll to the Remove Pirros parameters section and click Remove Pirros parameters

  5. Click Remove parameters in the confirmation dialog

  6. Save the model to keep the change

In Pirros in Revit, removal is permanent: the PirrosID and PirrosInSync values are deleted from the model and cannot be restored. It deletes the Pirros data on every view, sheet, schedule and view template in the project, deletes both parameters, and stops them from being added again — Pirros content you download into this model later comes in without them. It doesn't remove the Pirros data stored on families, family types and groups, or the model's link to its Pirros project. When it finishes, the panel shows how many views are no longer connected to Pirros. If the Remove Pirros parameters button is disabled with a "Connecting to Revit" message, give it a moment — if it does not clear, update the Pirros plugin, as this feature needs a newer version than the one running.

How to Remove Parameters in the Classic Plugin (v3.x)

  1. Open the Revit model that contains Pirros-downloaded details

  2. Go to Settings → About

  3. Control + Alt click the Pirros logo — the Pirros Diagnostics window opens

  4. Navigate to the Tools tab

  5. Click Remove Pirros Parameter Metadata

  6. Save the model

A Pirros Parameter data removed message confirms the change. If you don't see Remove Pirros Parameter Metadata on the Tools tab, your classic plugin version doesn't have it — update the plugin.

In the classic plugin, removal is reversible: the plugin keeps a hidden backup of the values inside the model, and the same button — now labelled Restore Pirros Parameter Metadata — adds the parameters back and reconnects the Details. Until you restore them, the classic plugin doesn't add the parameters back, keeps recording Pirros IDs and sync status in that hidden backup, and its Sync reads the IDs from there. If the model is later opened with Pirros in Revit, the parameters stay removed. If your client requires that no Pirros data remain in the file at all, be aware that this hidden backup stays in the model. Pirros in Revit deletes the values from views, sheets and schedules outright, but it also leaves the Pirros data on families, family types and groups, and the model's project link.

What This Affects

  • PirrosID is the unique identifier linking each Detail to its Pirros record. In Pirros in Revit, removing it means the plugin can no longer match these Details to the Library — if you sync this model later, Pirros will treat the Details as new uploads rather than updates. In the classic plugin, the IDs stay in the model's hidden backup, and the classic Sync still reads them from there.

  • PirrosInSync tracks whether the local Detail matches the Pirros version. Removing it has no functional impact beyond losing that status indicator.

When to Remove Parameters

  • Before client delivery — clients don't need Pirros parameters in their models

  • Before archiving — if the Project is complete and won't be synced again

  • Do NOT remove if you plan to continue syncing this model with Pirros, as it will cause duplicates on next sync

What Happens Next

After removing the parameters, the Details remain in your model as normal Revit views. In Pirros in Revit, they are no longer connected to Pirros, and the plugin will not recognize them for sync, Download Latest, or update purposes. In the classic plugin, their IDs stay in the model's hidden backup, and the classic Sync still reads them from there.

In the classic plugin you can reconnect them at any time with Restore Pirros Parameter Metadata. In Pirros in Revit, the only way to reconnect is to re-download the Details from the Library, which creates new copies with fresh Pirros IDs.

Frequently Asked Questions

Q: Will removing Pirros parameters affect how the Details look or print?

A: No. The parameters are metadata only — they do not affect the geometry, annotations, or appearance of any Detail.

Q: Can I add the parameters back later?

A: In the classic plugin, yes — the same button in the Tools tab becomes Restore Pirros Parameter Metadata and reconnects every Detail. In Pirros in Revit, no — removal is permanent. To reconnect Details to Pirros you would need to re-download them from the Library, which creates new copies with fresh Pirros IDs.

Q: Do I need to remove parameters from every view individually?

A: No. Removing the shared parameters at the Project level removes them from all views in the model at once.

Q: Why is the Remove Pirros parameters button grayed out in Pirros in Revit?

A: The panel is still connecting to Revit. If it stays disabled, your plugin version predates this feature — update the Pirros plugin and try again.

Did this answer your question?