What is a Revit ʼTagʼ and how does it differ from simple Text?
Short Answer
A Revit tag is an annotation object that reads live element data through the Tag by Category command, while simple text is just static drafting text with no link to the model. The most common professional method is using category-based tags tied to element parameters. Limitation: tags only display information available in loaded tag families and parameters.
What You Need to Know Before
Warning: A Revit tag can appear correct but still report the wrong value if the element parameter is empty, mapped incorrectly, or not shared in the tag family. A common failure is copying tags between views and missing view-specific visibility or phase/filter differences.
How to Use a Revit Tag Instead of Simple Text
Command: Tag by Category
Shortcut: TG
Quick Steps:
- On the Ribbon > Annotate tab > Tag panel, click Tag by Category.
- In the Options Bar, enable or disable Leader as needed, then hover over the model element you want to annotate.
- Click the element to place the tag, then drag to position it clearly in the view.
Variables & Settings
Key Setting: Leader option in the Options Bar
Expert Setting: Turning Leader on lets you tag crowded elements without overlapping geometry, while turning it off keeps documentation cleaner in simple layouts. Also check the tag family’s displayed label parameter, since that controls what data the tag actually shows.
Why it Fails
- Cause 1 (Geometry): The element cannot be tagged in that view because it is not visible, is too far from the annotation crop, or the selected tag family is not valid for that category.
- Cause 2 (layers/Locks): The element may be hidden by Visibility/Graphics, view filters, phase settings, design options, or a linked model that is not set up for tagging as expected.
- Cause 3 (Command/Logic): Simple text does not update with model changes, and a tag will not show useful data if the referenced parameter is blank or not included in the tag family.
Quick Fix & Best Practice
- Quick Fix: Use Tag by Category, then verify the element’s parameter values in Properties and confirm the correct tag family is loaded for that category.
- Manager’s Verdict: Use tags for any information that must stay coordinated with the model, and reserve simple text for notes, instructions, or temporary drafting comments only.
FAQ
Can a Revit tag update automatically when the model changes?
Yes, if the tag is linked to a valid element parameter.
Is simple text connected to Revit elements?
No, text is static and must be edited manually.
Can you tag linked model elements in Revit?
Yes, but it depends on the view setup, link settings, and tag support for linked elements.
.