Tags — Add tags and understand tag families

Historical Context & Motivation

Before the advent of Building Information Modeling, architectural documentation relied on hand-drafted annotations — small callouts, labels, and symbols drawn directly onto sheets of vellum or Mylar. Every time a door schedule changed or a wall type was revised, drafters had to locate and update each annotation manually, a tedious process that introduced significant risk of human error. The shift to computer-aided design in the 1980s digitized these annotations, yet the underlying problem persisted: labels and the objects they described remained disconnected, existing as independent geometry rather than as linked data. Autodesk Revit, introduced in 2000, fundamentally changed this paradigm by treating every building element as a data-rich object residing in a single, coordinated model. Within this framework, tags emerged as the primary mechanism for extracting and displaying element parameters directly in views, ensuring that annotations always reflect the current state of the model.

The central question that tags answer in the BIM workflow is deceptively simple: How do we display the right information, in the right place, at the right time, without ever letting annotation drift out of sync with the model? Understanding how tags work — and how tag families are structured — is essential for producing professional construction documents that meet industry standards while preserving your design narrative.

Core Principles & Definitions

Tags in Revit are a specific type of annotation element — view-specific 2D symbols that reference and display parameter values stored in model elements. Unlike model elements such as walls or furniture, tags do not carry geometric data that appears in 3D; instead, they exist only in the views where they are placed. Every tag is an instance of a tag family, which is a template file (with the .rfa extension) that defines the graphic appearance, label content, and display logic of the annotation. Grasping the relationship between tags, tag families, and the elements they annotate is foundational to producing coordinated documentation in any Revit project.

Visual Explanation — How Tags Connect to Elements

As shown above, the tag acts as a conduit between the model's stored data and what appears on a printed or exported sheet. This linkage is what makes BIM documentation fundamentally different from CAD drafting: the annotation is never an independent object but rather a live viewport into the element's metadata. When you change the door type from D-01 to D-02 in the model, every tag referencing that element across every view updates simultaneously. This principle — often called single source of truth — is the conceptual backbone of all Revit tagging workflows and is what eliminates the coordination errors that plagued traditional documentation methods.

How Tags Work — The Mechanism in Detail

Placing Tags in a View

Adding a tag to a Revit view is a straightforward process, but understanding each step clarifies how the software resolves which tag family to use and which parameter to display. When you invoke the Tag by Category command (found under the Annotate tab, or via the keyboard shortcut TG), Revit enters a placement mode that is category-aware. As you hover over elements in the view, the cursor snaps to recognizable categories — Walls, Doors, Windows, Furniture — and Revit automatically selects the loaded tag family that matches the element's category. If no matching tag family is loaded in the project, Revit prompts you to load one from your library.

Tag Options Bar Settings

Before clicking to place, the Options Bar at the top of the canvas offers several critical settings. The Leader checkbox determines whether a line connects the tag to the element, which is especially useful when an element is partially occluded or distant from the annotation zone. You can also toggle Orientation between horizontal and vertical, and choose whether the tag attaches to the element's centerpoint or follows the cursor for free placement. For room tags and area tags, an additional Tag on Placement toggle automatically tags elements the moment you create them, streamlining the documentation of repetitive spatial layouts.

Tag All Not Tagged

For large plans with dozens or hundreds of elements, Revit offers the Tag All Not Tagged command (Annotate tab → Tag All). This batch operation scans the active view for all elements of one or more selected categories that currently lack a tag, and places tags on every untagged instance simultaneously. The dialog allows you to choose which tag family to apply per category, whether to include leader lines, and whether the tag orientation should be horizontal. This command is a major productivity tool, but its results often require manual adjustment to avoid overlapping or poorly positioned annotations — a process that, in a visual arts context, mirrors the compositional fine-tuning you would perform when arranging labels in an exhibition layout.

Inside the Family Editor — Building a Tag Family

Creating or modifying a tag family requires working in the Family Editor, Revit's dedicated environment for authoring component templates. You begin by selecting a tag family template from Revit's default library — for example, Generic Tag.rft or Door Tag.rft. The template pre-assigns the correct annotation category. Inside the editor, you draw 2D geometry (lines, arcs, filled regions) to define the tag's graphic border, then insert a Label element — the dynamic text placeholder that maps to one or more element parameters. You configure the label's font, size, justification, and which parameters it displays. When finished, you save the family as an .rfa file and load it into your project.

Tag Family Classification & Anatomy

Revit ships with a default library of tag families organized by element category. Understanding this classification system, and knowing how to customize or replace default tags with your own, is essential for any firm that wants to maintain a consistent visual identity across its documents. The following diagram breaks down the anatomy of a tag family and shows how different tag types relate to the Revit category hierarchy.

Worked Example — Creating and Placing a Custom Door Tag

In this worked example, imagine you are documenting a contemporary art gallery. The gallery has twenty doors, and each must be tagged with both a type mark and a fire rating inside a rounded rectangular border, matching your firm's graphic standards. We will walk through creating the custom tag family and placing it in a floor plan view.

Tags vs. Other Annotation Methods — Strengths & Limitations

Tags are not the only way to annotate elements in Revit. Understanding how they compare to text notes, keynotes, and schedules helps you decide which tool is appropriate for each documentation scenario. The following table provides a systematic comparison.

Connection to Advanced Workflows

Once you are comfortable creating and placing basic tags, a range of advanced workflows opens up. These extend the tagging concept into parametric design, automation, and interoperability contexts that are increasingly relevant in professional practice and in the intersection of visual arts with architectural technology.

For visual arts students working on exhibition design, installation documentation, or museum renovation projects, the advanced extension of shared parameter ecosystems is particularly powerful. By defining a shared parameter like Artwork_Accession_Number and embedding it in both your furniture families (representing display pedestals) and a custom Generic Tag family, you can tag every pedestal in a gallery floor plan with the accession number of the artwork it holds. That same parameter can appear in a schedule on your sheet set, creating a complete, coordinated exhibition inventory — a workflow that traditional 2D drafting could never achieve with comparable reliability.

Practice Problems

Lesson Summary