If your Revit details use keynotes, here's what to expect when uploading to Pirros and downloading back into Revit.
How Pirros Interprets Keynotes in Uploaded Details
When you upload a Revit model to Pirros, any details that contain keynotes are ingested as-is. Pirros captures the keynote number as it appears in the drawing — however, because keynote definitions live in a separate project keynote file (not inside the Revit view itself), Pirros does not automatically pull in the meaning behind each number.
This means keynote numbers will be visible in the detail thumbnail and drawing, but without the associated keynote file, the definitions are not searchable by default.
What Happens to Keynotes on Upload
The keynote numbers appear in the detail exactly as they do in Revit
The keynote definitions (what each number means) are not automatically imported — they live in a separate .txt keynote file tied to the project
If keynote definitions are provided to Pirros, they can be imported into the Notes field of each detail, making them searchable by keyword, phrase, or number
What Happens to Keynotes When a Detail is Downloaded into Revit
When a user downloads a detail from Pirros into their active Revit project, the keynote numbers come through with the detail. However, for those keynotes to display correctly, the receiving project must have a compatible keynote file loaded. If the project's keynote file doesn't include the same keynote numbers, those annotations may appear blank or unresolved in Revit.
Best Practices for Managing Keynotes on Typical Details
Avoid keynotes on Typical Details when possible. Typical details are designed to be reusable across projects, but keynotes are project-specific by nature. A keynote that resolves correctly in one project may not resolve in another.
Use standard text annotations instead on Typical Details — these travel cleanly across projects without any dependency on a keynote file.
If keynotes are required on a typical, maintain a Master Keynote Legend and ensure all projects use a keynote file aligned to that master, so numbers resolve consistently across your firm.
If you want keynotes to be searchable in Pirros, provide your keynote definitions to your CSM — Pirros can import them into the Notes field so users can search by keyword or number.