Skip to main content

Avoid and Fix Duplicate Families (Pirros in Revit and Classic Plugin)

How duplicate families happen in Revit and Pirros, how to avoid and clean them up, 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 duplicate families happen

A duplicate family is usually the same-looking family arriving twice, often with a number added to the name. It almost always means the two copies have different or missing Pirros IDs, so Pirros can't treat them as the same piece of content. Common causes:

  • The same family was pulled from two different sources, such as the typical library and another project.

  • A family was edited in a file that didn't come from Pirros, so it has no Pirros ID.

  • An updated .rfa file was dragged onto the Families page. Drag and drop is for new families.

  • A model's linked project was changed after it was synced, so everything uploads as new.

Two ideas explain how Pirros decides what's the same:

  • Updates and syncs match by Pirros ID, not by name. This is why look-alike families with different IDs become duplicates.

  • When loading into your project, you choose whether to reuse a family your project already has or bring in a new copy. The Prevent duplicate families setting matches by family name.


Part 1: Avoid duplicates when you bring families into a project

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

  1. On the panel's Settings tab, check that Prevent duplicate families is on. It's on by default. It makes the details you download, and families nested inside groups, reuse a family your project already has instead of loading another copy (details may look slightly different as a result). It doesn't apply to a family you insert directly; steps 2 and 3 cover that.

  2. Insert the family from the Browse tab. If your project doesn't have it yet, a family with several types opens Select types to import, where every type starts checked; uncheck the types you don't want.

  3. If the family is already in your project, Insert and drag don't load another copy: Pirros puts the family you already have on your cursor. To add types from Pirros to it, click the family to open its type list, check the types you want and click Insert. Types your project already has are then listed under Types already in project in Some items already exist in this project (the same window appears when you insert several items, or a stash, that include a family your project already has). Choose for each type:

    • Skip (the default): leaves your project's type as it is.

    • Replace existing: updates your project's type with the values from Pirros.

    • Keep my version: downloads nothing and links your project's type to the Pirros family, so future updates track it.

    Apply to all family types: sets the same choice for every type at once. Click Apply to continue. There's no per-family choice, and Keep both isn't offered for families.

Newly added types are added in place instead of reloading the whole family, and families with conflicting names in the same folder are handled during download.

Option B: Classic plugin (v3.x)

When a family you download is already in your project, the Download Items dialog marks it Already in project on the Families tab, and each type your project already has shows In project with an Action:

  • Link Existing: downloads nothing; it matches the incoming family to the family already in your project and records the correct Pirros ID so future updates track. If the family can't be found in your project, those types are downloaded instead.

  • Download New: loads the type from Pirros.

  • Skip (the default): leaves your project's type untouched.

To set one action for every family type that's already in your project, choose it in the list above the families and click Apply. Apply changes the choices straight away without asking you to confirm, so check them before you click Confirm. If you don't see Apply, your classic plugin version doesn't have it; choose the action type by type.

For families used inside the details you download, Prevent duplicate families (at the bottom of the dialog, ticked by default) reuses the family your project already has instead of loading another copy. If you don't see this checkbox, your classic plugin version doesn't have it and always reuses your project's family.

New family types can also be added to a family that already exists in your project. Check the new types you want; depending on your classic plugin version, they may start unchecked.

Which choice should I make?

Situation

Choose

My template already has this family and I want it left alone

Skip for its types (the default in both versions), and keep Prevent duplicate families on for families inside details

The detail relies on a version of the family that differs from mine

Turn Prevent duplicate families off for that download, so Pirros allows a second copy of the family instead of reusing yours (classic: only versions that have the checkbox)

My project's family is the right one, and I want it tied to the Pirros version for future updates

Link Existing (Keep my version in Pirros in Revit)

I'm not sure

Keep the defaults (Skip, with Prevent duplicate families on), then check the result


Part 2: Clean up duplicates already in your project

You can't merge two families on the Pirros website. Fix it in Revit:

  1. Work out which copy has the correct, shared Pirros ID. Both plugins show a Pirros ID column in the Families list of Sync (choose All Families under Filter By); you need permission to sync families to see it. If two families share the same Pirros ID, opening the Sync tab in Pirros in Revit keeps the ID on the first one by name and removes it from the others.

  2. Re-link the instances in your model to that copy.

  3. Delete the duplicate that has the different or missing ID.

Don't copy a Pirros ID from one family to another to force a match. That causes more problems. If several models have drifted apart, see Keeping Multiple Building Models in Sync with Pirros for a cleanup approach.


Part 3: Avoid duplicates in the Pirros library (admins)

  • Start from a file that came from Pirros. Download the current family, edit that exact file, then update it, or edit inside a synced Revit model.

  • Use Edit Family on the family's page to update an existing family. This adds a new version under the same Pirros ID.

  • Don't drag an updated .rfa onto the Families page. It has no Pirros ID, so Pirros creates a duplicate.

  • Edited a family outside Pirros? Download the current version, re-apply your changes to that file, then update it. Pirros Support can also help apply an outside edit to the existing family.

  • Don't change the project on a model that has already been synced unless you intend to re-upload everything.

  • Made a mistake? Every update adds a version and nothing is deleted. You can restore an earlier version from the family's version history.


Frequently Asked Questions

Q: I downloaded a family and got a copy with a number after the name. What happened?

A: The two families have different or missing Pirros IDs. Keep the one with the correct ID, re-link your instances to it, and delete the other.

Q: Can I merge duplicate families on the Pirros website?

A: No. Fix it in Revit by re-linking instances and deleting the extras.

Q: Why did Prevent duplicate families keep my family, but sync still treats it as new?

A: Prevent duplicate families matches by name when loading. Syncing and updating match by Pirros ID. If your local family has no matching ID, use Link Existing (Keep my version in Pirros in Revit) so the correct ID is recorded.

Q: Which Revit versions have each option?

A: It depends on your plugin generation, not the Revit year. Pirros in Revit (v4.x) is available on Revit 2024 and newer once enabled for your firm. In the classic plugin, the Prevent duplicate families checkbox and the bulk Apply are only in newer versions. See Revit Version Compatibility Matrix.

Did this answer your question?