How to tag air terminals in Revit: diffusers, grilles, and registers, step by step
Tag air terminals in Revit step by step. Load the air terminal tag, tag diffusers and grilles, show type mark and airflow, fix zero flow and repeated letters, and see how RayCAD tags ceilings.
On this page
- What do you need before you tag air terminals?
- How do you tag an air terminal in Revit?
- How do you make the tag show the right values?
- How do you fix zero airflow on an air terminal tag?
- How do you tag a rotated or linear slot diffuser?
- What goes wrong with air terminal tags?
- What else breaks when you tag air terminals by hand?
- How does RayCAD tag air terminals end to end?
- What should you check before you issue the sheet?
- Questions
- Sources
Every diffuser and grille on a ceiling plan needs a tag. The reader finds out which system it serves, what type it is, and how much air it moves. Revit places the tag, and the tag family decides what it says.
This guide covers the job in order. You load a tag, place it, make it show the right values, and then deal with a crowded ceiling. RayCAD is a Revit plugin that tags air terminals and the rest of an HVAC sheet. After each step, you'll see where it costs time and what RayCAD changes.
What do you need before you tag air terminals?
- A view that shows the terminals. A reflected ceiling plan or a floor plan, set so air terminals are visible.
- A loaded air terminal tag. Air terminals have their own tag category, called Air Terminal Tags. A duct tag does not cover them.
- Air terminal tags turned on in the view. Check the Annotation Categories tab in Visibility/Graphics (VG) and the view template.
How do you tag an air terminal in Revit?
1. Load an air terminal tag
- Go to the Annotate tab and open the drop-down arrow on the Tag panel.
- Choose Loaded Tags and Symbols.
- Click Load and browse to an air terminal tag. The tags that ship with Revit sit in the Annotations folder of your Revit library, under Mechanical.
- Check that the tag name now appears next to Air Terminal Tags, then click OK.
The last tag you load for a category becomes the default. Load your firm's tag last.
2. Tag one terminal with Tag by Category
- Open the ceiling plan.
- Go to Annotate, Tag, Tag by Category, or type TG.
- Set the orientation, and turn the leader on or off, on the Properties palette or the Modify | Tag tab.
- Click a diffuser. The tag appears.
- Drag the tag to move it. Press Esc twice to leave the command.
A diffuser is a solid element, so put its tag beside it, not on it. Many offices keep the leader off when the tag has room and turn it on when it does not.
3. Tag every terminal at once with Tag All Not Tagged
- Open the view. Select the terminals you want tagged, or select nothing to tag all of them.
- Go to Annotate, Tag, Tag All.
- In the Tag All Not Tagged dialog, choose All objects in current view or Only selected objects in current view.
- Select Air Terminal Tags.
- Set Leader, Leader Length, and Tag Orientation, then click OK.
This is a good fit for air terminals, because nearly every one needs a tag. It skips terminals that already have a tag, and it runs on the active view only.
How do you make the tag show the right values?
A common air terminal tag shows a type mark and an airflow. To change what yours shows:
- Select a tag and click Edit Family.
- Save a copy under a new name.
- Select the label and click Edit Label.
- Replace Mark with Type Mark if every tag shows the same letter, such as L, L, L. Mark is an instance parameter and Type Mark is a type parameter.
- Add Flow if the tag should show airflow, and set its unit format.
- Click Load into Project, and choose to overwrite the existing version if Revit asks.
How do you fix zero airflow on an air terminal tag?
Airflow on a terminal comes from the duct system connected to it. If the tag shows zero or a blank value:
- Check that the terminal connects to a duct, and that the system has no disconnected pieces. Revit shows warnings for these.
- If the terminal is a custom family, open it and check that the flow parameter links to the connector's flow.
- Wait for Revit to finish calculating after a change.
- Confirm that the tag label reads the Flow parameter and not a different one.
- Install the latest Revit update. In the first release of Revit 2024, air terminal tags could show zero flow, and users report that updates fixed it.
How do you tag a rotated or linear slot diffuser?
A tag follows the view by default and stays horizontal. A rotated terminal is easier to read with a horizontal tag beside it. If your standard wants the tag to follow a long terminal, such as a linear slot diffuser, the tag family needs Rotate with component turned on. Edit the family, change the property, and load it back into the project.
What goes wrong with air terminal tags?
| What you see | What to check |
|---|---|
| Tag All places nothing | The terminals may already have tags, or the category is hidden in the view or its template. |
| Every tag shows the same letter | The label reads an instance parameter. Read Type Mark instead. |
| Airflow shows zero | Check connections, then the family's flow link. |
| The tag shows a question mark | The label reads a parameter the terminal does not have. |
| Tags overlap lights or sprinklers | Revit does not check overlaps. Move them by hand. |
| Return grilles have no tag | Check that the tag category is on, and that the grille is an air terminal family. |
What else breaks when you tag air terminals by hand?
Missed terminals. One diffuser without a tag becomes a question on site. If RayCAD can't place a tag, it says so, gives the reason, and takes you to the terminal. See how that reduces RFIs.
Model changes. When a terminal moves, its tag stays where it was. RayCAD's Retag tool tags the selected terminals again with the settings you used.
How does RayCAD tag air terminals end to end?
You pick the views. RayCAD finds every diffuser, linear slot diffuser, and grille, decides where each tag goes, places it, and lists anything it could not place. You review the result. A click-saver plugin speeds up each manual click and leaves the deciding and placing with you.
RayCAD tries the sides of a terminal in turn, above, right, left, and below, and moves to the corners only when every side is full. It works in floor plans and section views, and you save the setup as a preset for the project.
| Task | In Revit by hand | With RayCAD |
|---|---|---|
| Tagging every terminal | One click each, or Tag All with default offsets | All terminals in the views you pick |
| Keeping tags off lights and sprinklers | You move them | Each position is checked against the model and other tags |
| Aligning to rotated terminals | Family edit and checks | Tag aligned to the terminal |
| Finding what needs attention | You scan the sheet | A review panel |
What should you check before you issue the sheet?
- Every diffuser, grille, and register has a tag.
- Tag values match the air terminal schedule.
- No tag covers a light, a sprinkler, or another tag.
- Airflow values are not zero.
- Section views show the same terminals as the plan.
RayCAD supports Revit 2021 to 2027. Start a free trial, or get a demo and an onboarding call. The HVAC tagging page covers the ducts and equipment behind the terminals.
What building an air terminal tagging script yourself really costs
- Time. Whoever builds and maintains the script is doing software development instead of the billable engineering and drafting work they were hired for.
- The AI loop.With Claude or ChatGPT it becomes an endless loop of “fix this”, “now fix that”. Each fix can break a case that worked before, and nobody on the team owns the code.
- Cost. Hours spent building and maintaining scripts, times your hourly rate, against $200 per month for RayCAD for the whole company.
You can build an air terminal tagging script, and this page shows how. For production MEPF sheets, RayCAD is the cheaper and safer choice. Try it free for 15 days.
Frequently asked questions
How do you tag a diffuser in Revit?
Load an air terminal tag, go to Annotate, Tag, Tag by Category, and click the diffuser. To tag every diffuser in the view, use Tag All Not Tagged and select Air Terminal Tags.
Why does my air terminal tag repeat the same letter?
The label is reading an instance parameter, such as Mark, that holds the same value on every terminal. Edit the family and read Type Mark instead.
Why does my air terminal tag show zero airflow?
Flow comes from the connected duct system. A disconnected system, or a family whose flow parameter is not linked to its connector, can leave the value at zero. Check the connections first.
What goes on an air terminal tag?
Most offices show a type mark, which ties the terminal to the schedule, and the airflow. Some add the system name.
Should I use Tag All or Tag by Category for air terminals?
Tag All Not Tagged works well because every terminal normally needs a tag. On a crowded ceiling, Tag by Category gives you control over each position.
Can RayCAD tag diffusers and grilles?
Yes. RayCAD tags diffusers, linear slot diffusers, and grilles, including return and exhaust grilles and registers, in floor plans and section views.
Sources
- Autodesk Community, Diffuser airflows resetting to 0 (checked October 21, 2026)
- Autodesk Revit help, Tag All Not Tagged (checked October 21, 2026)
- Autodesk Revit help, Tag by Category (checked October 21, 2026)
- Autodesk Revit help, Load a Tag or Symbol Style (checked October 21, 2026)
- VDCI, Optimizing air terminal tagging (checked October 21, 2026)
- Noble Desktop, Annotating mechanical sheets in Revit (checked October 21, 2026)