To report a problem with a detail — or suggest it for promotion to your firm's typical library — flag it for your admin team to review.
This video demonstrates the full flagging workflow: selecting a detail, adding a flag comment with markup, tagging colleagues, and how admins review and resolve flags. The step-by-step text below covers everything in the video.
How to Flag a Detail
An animated walkthrough showing a user opening a detail, clicking the Flag icon, adding a comment, and submitting the flag. The flag appears in the admin's Management tab for review.
Search for and click on the detail you want to flag
The Details page showing a detail card. Click on the detail to open it in the preview panel.
Click the Flag icon at the top right corner of the detail view
The detail view with the Flag icon highlighted in the top right. Click it to open the flagging panel on the right side of the screen.
Describe the issue in the comment box at the bottom right
The flag comment box at the bottom right of the detail view. Type a description of the issue — for example, "Flashing detail doesn't match current IBC requirements" or "This should become a typical."
Use the @ symbol to tag specific colleagues if you want their attention
The comment box showing the @ mention dropdown. Type @ followed by a colleague's name to tag them. They receive a notification about the flag.
Use the Pencil tool at the bottom of the comment box to mark up the detail image and indicate what needs to change
The markup tool overlay. Click the pencil icon to draw directly on the detail image — circle the area that needs attention or draw arrows pointing to specific issues.
Use the attachment icon to attach supporting files. Supported file types: RVT, RFA, PNG, JPG, and PDF
The attachment icon in the comment toolbar. Click it to upload files from your computer — Revit models (RVT), family files (RFA), images (PNG, JPG), or PDF documents that help the admin understand the issue.
Click the send icon (orange airplane) to submit the flag
The send button (orange airplane icon) at the bottom right of the comment box. Click it to submit your flag. Your admin team receives a notification immediately.
How Admins Review and Resolve Flags
An animated walkthrough of the admin flag review process: opening the Management tab, viewing flagged details, reading comments, and clicking Resolve Flags after updating the detail.
Admins see all flagged details in Management → Flagged Details:
Click Management in the top navigation bar, then Flagged Details
The Management tab showing the Flagged Details option in the left sidebar. Click it to see all active flags from your team.
Review the flagged details and add comments
The flagged details queue showing each flagged detail with the user's comment and markup. Use the comment box to respond or add notes before resolving.
After updating the detail in Revit and syncing, click Resolve Flags
The Resolve Flags button at the top of a flagged detail. Click it after the issue has been addressed. The flag is cleared from the active queue but preserved in the detail's Flags history.
Resolved flags remain visible in the detail's Flags section for reference. Navigate to the detail, click Flags on the left panel, then click Resolved Flags to view past flag history.
The detail's Flags tab in the left panel. Click it to view both active and resolved flags.
The Resolved Flags view showing past flag history with comments, timestamps, and who resolved each flag.
What Happens Next
After you submit a flag, your admin team receives a notification via email and in the Pirros Management tab. Once they review the flag, update the detail, and click Resolve, you receive a notification that the issue has been addressed.
Frequently Asked Questions
Q: Can I flag a detail to suggest it should become a typical?
A: Yes. Use the flag comment to explain why — for example, "We use this detail on every healthcare project, it should be a firm standard." Your admin sees this in their flagged queue.
Q: Will I be notified when my flag is resolved?
A: Yes. When an admin resolves a flag, you receive a notification that the detail has been updated.
Q: Can I flag multiple details at once?
A: Flags are submitted one detail at a time. Each flag has its own comment thread and can be resolved independently.
Q: What's the difference between flagging and requesting?
A: Flagging is for details that already exist in Pirros and need attention (errors, updates, promotion to typical). Requesting is for content that doesn't exist yet — use Request Details or Request Project for that.
Q: What file types can I attach to a flag?
A: You can attach RVT (Revit models), RFA (family files), PNG, JPG (images), and PDF documents.