To preserve live section callouts and reference bubbles when downloading details from Pirros into Revit, you need to download the related details together. This article explains how view references work, what is supported, and how to avoid broken references.
What Pirros Supports
Pirros supports importing and maintaining live references from section references and callouts. When you download details that contain these references, the reference bubbles come in live -- meaning they link to the referenced views in your Revit project.
How to Keep References Alive
The key rule: download the "parent" and "child" details together in one batch.
If a detail has a section callout that references another detail, both details must be downloaded in the same stage-for-download batch. You can do this by:
Staging both details from the search page, or
Adding all related details to a Stash and staging the stash for download at once
What Happens When References Break
Scenario | Result |
Download parent and child together with their sheet | Reference bubbles are live and clickable with correct sheet and detail numbers |
Download parent and child together, without the sheet | Reference bubbles appear but look blank or inactive -- the linked sheet number does not exist in the model |
Download only the parent or only the child | Reference bubbles disappear and the linked detail is not brought in |
Best Practice: Download the Entire Sheet
To preserve full reference functionality:
On the Details page, apply the Detail Type filter and select Sheets.
The Detail Type filter on the left panel with "Sheets" selected.
Find the sheet that contains the details you need. Click the sheet card.
Click Open Full Detail to open the sheet page. You see a large view of the sheet with all individual details listed on the right side.
The sheet detail page showing the full sheet preview and a list of individual details on the right.
Stage for Download or Insert the sheet. This downloads the sheet and all its details together, preserving all reference connections.
After downloading, section callouts and reference bubbles appear in Revit with their original sheet and detail numbers preserved.
Alternative: Use a Stash for Referenced Details
If you do not need the full sheet, you can still preserve references by grouping the parent and child details:
Find the detail that has references (look for the references indicator on the detail page).
A detail page showing the References section with linked details listed.
Create a User Stash and add all referenced details to it.
A stash containing a parent detail and its referenced child details.
Stage for Download from the stash to download all details in one batch.
The stash page with the Stage for Download button highlighted.
FAQ
Q: How do I know if a detail has references?
A: Open the full detail page. The References section lists any section callouts or view references linked to that detail.
Q: Can I fix broken references after downloading?
A: If you downloaded details separately and references are broken, download the missing linked details. In some cases, you may need to re-download all related details together in one batch.
Q: Does this apply to all view types?
A: Reference preservation applies to section references and callouts. Other reference types (elevation tags, grid references) are not currently managed by Pirros.
Q: What if I download a detail and the reference bubble shows but is blank?
A: This means the referenced detail was downloaded but the parent sheet was not. The reference ID is live in the system, but the sheet number does not exist in the model. Download the sheet to resolve this.
Q: Do I need to download the sheet every time?
A: Not always. If you download the parent and child details together, the references are technically live. Downloading the sheet ensures the sheet numbers in the reference bubbles display correctly.