Autodesk Revit • Sheets and Publishing

Revisions — Manage revision clouds/revision schedules for issued sheets (intro)

Track, communicate, and document design changes on issued construction sheets using Revit's built-in revision system.

A building model with layered plans and dimension marks.
Inside this lesson 10 sections 5 questions 5 figures

SECTION 1

Historical Context & Motivation

The practice of tracking changes to construction documents is as old as architectural drawing itself. Before digital tools, architects and engineers would physically mark up blueprints with hand-drawn clouds — irregular, looping lines that called attention to areas of a drawing that had been modified after an initial issuance. These revision clouds served a critical contractual and communicative function: they told contractors, consultants, and building officials exactly what had changed, when it had changed, and why. Without a reliable revision tracking system, construction projects risked costly misunderstandings — a wall moved on paper but not communicated to the field could cascade into weeks of rework and tens of thousands of dollars in change orders.

As the AEC (Architecture, Engineering, and Construction) industry transitioned from hand drafting to CAD and eventually to Building Information Modeling (BIM), the need for structured, auditable revision tracking only intensified. Autodesk Revit, introduced in 2000, brought a paradigm shift by embedding revision management directly into its sheet-based publishing workflow. Rather than relying on manual bookkeeping, Revit's revision system links clouds drawn on views to a centralized revision schedule — a table that automatically populates on the sheet's title block, creating a single source of truth for document control.

Pre-1980s • Hand-Drafted Revision Clouds

Architects drew freehand cloud shapes on mylar or vellum sheets to indicate areas of change. Revision tables were typed or hand-lettered in title blocks, and tracking relied on office filing systems.

1982–1999 • CAD-Era Revision Marking

AutoCAD introduced digital revision cloud commands, but clouds were simple polylines with no metadata connection to title blocks. Revision schedules were still manually maintained text blocks — prone to human error and version drift.

2000 • Revit Launches with BIM-Integrated Revisions

Revit's founding premise — a single coordinated model — extended to document management. Revision clouds became intelligent objects linked to revision sequences, and revision schedules auto-populated in title block families.

2010s • Cloud-Based Collaboration & Issuing

Revit introduced the 'Issued' status for revisions, locking revision clouds to prevent accidental editing. BIM 360 (now Autodesk Construction Cloud) enabled real-time collaboration, making revision discipline even more critical across distributed teams.

2020s • Modern Revision Workflows

Current Revit versions support numbering modes (per project vs. per sheet), visibility toggling, and integration with Autodesk's cloud publishing pipelines — connecting revision tracking to field-ready mobile document sets.

The central question that Revit's revision system answers is deceptively simple: How do you ensure that every stakeholder on a construction project knows exactly what changed on a drawing, and when? Understanding this system is essential for any visual arts student entering architectural practice, interior design, or exhibition design, where issued documents carry legal weight.

SECTION 2

Core Principles & Definitions

Revit's revision system operates on a small set of interconnected concepts. Before placing a single cloud, you need to understand the hierarchy: a revision is a project-wide event (e.g., 'Revision 1 — Owner requested kitchen relocation'), a revision cloud is a graphical annotation placed on a view that belongs to that revision, and the revision schedule is the automated table in the title block that lists all revisions appearing on a given sheet. These three elements form a closed loop: you define revisions in the project settings, draw clouds that reference those revisions on views, and the schedule on each sheet reports which revisions affect it.

1

Revision (the Event)

A row in the Sheet Issues/Revisions dialog (View → Sheet Issues/Revisions). Each revision has a sequence number, date, description, and an Issued status. Revisions are ordered sequentially — the first revision is always at the bottom of the list.
2

Revision Cloud (the Annotation)

A view-specific graphical element placed with the Annotate → Revision Cloud tool. Each cloud is associated with one revision from the project list. Clouds can be sketched freely or converted from existing lines.
3

Revision Schedule (the Report)

A schedule embedded in the sheet's title block family. It auto-populates with revision data for clouds visible on that sheet. Architects typically show revision number, date, and description columns.
4

Issued Status (the Lock)

When a revision is marked as Issued, its associated clouds become read-only — they cannot be moved, edited, or deleted. This protects the contractual record. New changes require a new revision row.
5

Numbering Mode

Revit offers two numbering schemes: Per Project (a single global sequence across all sheets) and Per Sheet (each sheet has its own independent count starting from 1).
✦

KEY TAKEAWAY

Think of the revision system like a gallery exhibition's version log. The revision is the curatorial decision ('Move the sculpture three feet left'), the revision cloud is the sticky note placed on the floor plan marking the change, and the revision schedule is the master changelog posted at the gallery entrance. Once an edition is printed and distributed (Issued), you can't alter the sticky notes — you must start a new round of changes.

SECTION 3

Visual Explanation — The Revision Workflow

The diagram below illustrates the complete lifecycle of a revision in Revit, from defining the revision event to issuing the sheet. Follow the numbered steps to understand how data flows from the project-level settings dialog through the view-level annotation and into the sheet's title block.

Revision Lifecycle in Autodesk Revit① DEFINE REVISIONView → Sheet Issues/ Revisions dialogSeq, Date, Desc, Status② DRAW CLOUDAnnotate → RevisionCloud tool in viewAssign to Rev #③ SHEET SCHEDULETitle block auto-populates revisionNo., Date, Description④ ISSUE REVISIONMark as Issued →Clouds lock (read-only)Sample Sheet: A101 — Floor Plan[Floor Plan View]Rev Cloud▲1REVDATEDESCRIPTION101/10/25Kitchen relocated per owner
The four-step revision lifecycle: define the revision event in the project dialog (①), draw clouds on the affected views (②), the revision schedule in the title block automatically reflects those clouds (③), and issuing the revision locks all associated clouds (④). The sample sheet at bottom shows a revision cloud on the floor plan with its corresponding schedule row.

Notice how the workflow is deliberately linear: you cannot draw a revision cloud until a revision row exists in the project dialog, and the sheet's title block won't display revision data until at least one cloud referencing that revision appears on a view placed on the sheet. This enforced sequence prevents the kind of orphaned annotations and mismatched tables that plagued earlier CAD workflows. The Issued status at the end of the cycle acts as a contractual seal — once checked, the revision's clouds become immutable, and any further changes to the design must be recorded under a new revision number.

SECTION 4

How Revit's Revision System Works Under the Hood

Understanding the mechanics of Revit's revision system requires familiarity with the relationship between the Sheet Issues/Revisions dialog, individual revision cloud instances, and the title block family's built-in revision schedule. The dialog — accessed via View → Sheet Issues/Revisions — is the control center. Each row you add creates a revision object with the following parameters: Sequence Number (auto-assigned based on list position), Numbering (numeric, alphabetic, or none), Date, Description, and Issued (a checkbox). The order matters: revisions are listed bottom-to-top chronologically, with the oldest at the bottom.

Revision Cloud Placement

When you select the Revision Cloud tool (Annotate tab → Detail panel → Revision Cloud), the Options Bar presents a dropdown listing all non-issued revisions in the project. You select the target revision, then sketch the cloud boundary in the view. Revit draws the characteristic arc-segmented outline automatically. Each cloud instance carries metadata tying it to its parent revision. You can also add a revision tag — a small triangle or delta symbol with the revision number — adjacent to the cloud for clarity. If you use Annotate → Tag By Category after placing the cloud, Revit applies the tag automatically.

Visibility Settings: Cloud and Tag, None, or Tag Only

Back in the Sheet Issues/Revisions dialog, each revision row has a Show column with three options: Cloud and Tag displays both the cloud outline and its delta tag on sheets; Tag hides the cloud but keeps the tag visible (useful for older revisions where the cloud would clutter the drawing); and None hides both entirely while keeping the revision in the schedule. This progressive hiding is essential for legibility — a sheet that has undergone six revisions would become unreadable if all six sets of clouds remained visible.

The Revision Schedule in the Title Block

Revit's default title block families include a Revision Schedule — a specialized schedule type that can only exist inside a title block family. It filters its content per sheet: only revisions whose clouds appear on views placed on that specific sheet will show. This means Sheet A101 might display Revisions 1 and 3, while Sheet A201 displays only Revision 2, even though all three revisions exist in the project. The schedule columns (Number, Date, Description) are configurable in the family editor, but most firms follow AIA or ISO standards for column order.

ℹ

Per Project vs. Per Sheet Numbering

In Per Project mode, revision numbers are globally sequential — Revision 3 is Revision 3 on every sheet. In Per Sheet mode, each sheet starts its count from 1, so the second revision on Sheet A201 is labeled '2' regardless of the project-wide count. Most U.S. architectural firms use Per Project numbering because it simplifies cross-referencing in Requests for Information (RFIs) and addenda.

SECTION 5

Anatomy of the Revision Dialog & Cloud Properties

The Sheet Issues/Revisions dialog is compact but dense with information. The following diagram breaks down its layout and maps each column to the data it controls. Understanding this dialog is the gateway to competent revision management — every decision you make here propagates to every cloud and every title block in the project.

Sheet Issues/Revisions Dialog — AnnotatedSheet Issues/RevisionsSEQNUMBERINGDATEDESCRIPTIONISSUEDSHOW3Numeric: 301/15/25MEP coordination update☐Cloud & Tag2Numeric: 212/20/24ADA restroom compliance☑Tag1Numeric: 111/05/24Owner kitchen relocation☑NoneNumbering mode:Per Project ▾AddDeleteMove UpMove DownColumn Legend:Seq — Position in the revision list (bottom = oldest)Numbering — Numeric, Alphabetic, or NoneDate — When the revision was issuedDescription — Brief reason for the changeIssued — Locks all associated cloudsShow — Cloud & Tag, Tag only, or None
Annotated view of the Sheet Issues/Revisions dialog. The three rows show revisions in chronological order (oldest at bottom). Revision 1 and 2 have been issued (☑), making their clouds read-only. Revision 3 is still active. The legend below maps each column header to its function.
PropertyLocationEffect
Revision NumberCloud Properties paletteDetermines which revision the cloud belongs to; selectable from dropdown of non-issued revisions.
CommentsCloud Properties paletteOptional text note attached to the individual cloud — useful for internal coordination but not shown on sheets by default.
MarkCloud Properties paletteA custom identifier (e.g., 'SK-03') that can be displayed via a revision tag family.
Issued to / Issued bySheet Issues/Revisions dialogText fields for recording the recipient and author of the issuance — typically the client name and the project architect.

Key properties of revision clouds and revision rows

SECTION 6

Worked Example — Adding a Revision to an Issued Sheet

Imagine you are working on a small gallery renovation project. Sheet A102 (Reflected Ceiling Plan) was issued to the contractor two weeks ago. The owner has since requested a change: the track lighting layout in Gallery Room B must be repositioned to accommodate a new art installation. You need to document this change as Revision 2 on the project.

Adding Revision 2 — Track Lighting Relocation

  1. 1

    Step 1 — Open the Sheet Issues/Revisions Dialog

    Navigate to View → Sheet Issues/Revisions. You'll see Revision 1 already listed (dated two weeks ago, description: 'Initial issuance to contractor') with the Issued checkbox checked.
  2. 2

    Step 2 — Add a New Revision Row

    Click the Add button. A new row appears above Revision 1 with Sequence number 2. Enter the date (today's date), set the description to 'Track lighting relocation — Gallery Room B per owner request,' and leave the Issued checkbox unchecked. Confirm the numbering mode is set to Per Project. Click OK.
    Revision 2 now exists as an active (non-issued) revision in the project.
  3. 3

    Step 3 — Navigate to the Reflected Ceiling Plan View

    In the Project Browser, expand Views → Ceiling Plans and double-click 'Reflected Ceiling Plan — Level 1.' This is the view that is placed on Sheet A102.
  4. 4

    Step 4 — Draw the Revision Cloud

    Go to Annotate → Revision Cloud. In the Options Bar, confirm the Revision dropdown shows 'Revision 2.' Use the sketch tools (Lines, Rectangles, or Freeform) to draw a cloud around the lighting fixtures in Gallery Room B. When you're done sketching, click the green checkmark (✔ Finish) on the ribbon.
    An arc-segmented revision cloud now encloses the modified area. Its Properties palette shows 'Revision Number: 2.'
  5. 5

    Step 5 — Tag the Cloud

    With the cloud still selected (or after selecting it), go to Annotate → Tag by Category. Click near the cloud to place a revision tag. The tag displays a delta symbol (△) with the number '2.' Drag it to a clear location if it overlaps other annotations.
  6. 6

    Step 6 — Verify the Sheet

    Open Sheet A102 in the Project Browser. The revision cloud should be visible in the reflected ceiling plan viewport, and the title block's revision schedule should now show a new row: 2 | [Today's Date] | Track lighting relocation — Gallery Room B per owner request. Print or export the sheet for distribution.
    Sheet A102 is updated with a clearly marked and scheduled revision. The change is traceable, dated, and described.
  7. 7

    Step 7 — Issue the Revision (After Distribution)

    After the revised sheet has been distributed to the contractor, return to View → Sheet Issues/Revisions and check the Issued checkbox for Revision 2. The cloud and tag on Sheet A102 are now locked — no one on the team can accidentally modify or delete them. Any future changes will require Revision 3.
    Revision 2 is now formally issued and its clouds are immutable.

SECTION 7

Strengths, Limitations, and Common Pitfalls

StrengthsLimitations
Revision schedules auto-populate from cloud data — no manual table editing needed, reducing the risk of mismatched information.Revision clouds are view-specific, not model-wide. If the same wall change affects three views, you must draw three separate clouds.
The Issued lock prevents accidental edits to contractual documentation, creating a reliable audit trail.Once a revision is issued, you cannot un-issue it in a workshared (central model) environment without potential synchronization conflicts.
Visibility controls (Cloud & Tag, Tag, None) let you manage visual clutter on sheets with many revisions.Revision schedules in title blocks have limited formatting options — customizing beyond standard columns requires editing the title block family.
Per Project and Per Sheet numbering modes accommodate different firm standards and project contractual requirements.Revisions cannot be assigned to specific project phases, which complicates phased delivery strategies like Design-Build or IPD.
Integration with Autodesk Construction Cloud enables cloud-to-field revision tracking and mobile document access.No built-in approval workflow — 'Issued' is a manual toggle without sign-off authentication, unlike dedicated document management systems.

Strengths and limitations of Revit's revision system

⚠

COMMON PITFALL

The most frequent mistake new Revit users make is issuing a revision prematurely — before all clouds have been placed — and then discovering they cannot add more clouds to that revision. Think of the Issued checkbox like signing and mailing a letter: once it's in the postal system, you can't open the envelope and add another paragraph. Always confirm that every affected view has its revision clouds placed before clicking Issued.

SECTION 8

Connection to Advanced Revision Workflows

The introductory revision workflow covered in this lesson provides the foundation for more sophisticated document control strategies used in professional practice. As projects scale — from a single gallery renovation to a multi-building campus — the limitations of basic revision management become apparent, and advanced techniques become essential. Understanding where this introductory knowledge leads will help you contextualize each skill as you progress.

Introductory ConceptAdvanced Extension
Manual revision cloud placement in individual viewsDynamo scripting to auto-generate revision clouds from clash detection reports or change-order databases
Single title block revision scheduleCustom revision schedule families with conditional formatting, QR codes linking to BIM 360 transmittal records
Per Project / Per Sheet numberingHybrid numbering with custom parameters for discipline-specific sub-numbering (e.g., S-1, M-2, A-3)
Manual Issued checkboxAutodesk Construction Cloud transmittal workflows with automated issuance tracking, digital signatures, and recipient confirmation logs
Static cloud visibility (Cloud & Tag / Tag / None)View filters and phase-based visibility rules that conditionally show/hide clouds based on project milestones

Introductory vs. advanced revision management concepts

For visual arts students who may go on to work in exhibition design, set design, or architectural visualization, the key takeaway from this advanced landscape is that revision management is not just a technical Revit skill — it is a professional communication practice embedded in legal contracts, insurance requirements, and collaborative project delivery frameworks. The introductory tools covered here equip you to participate in that practice; advanced coursework will prepare you to lead it.

SECTION 9

Practice Problems

Question 1: CONCEPTUAL

Explain the functional difference between a revision and a revision cloud in Revit. Why does Revit require both, rather than treating each cloud as its own independent revision event?
Show answer
A revision is a project-level event — a single entry in the Sheet Issues/Revisions dialog that represents a set of changes issued at a specific date (e.g., 'Structural coordination updates, 03/15/25'). A revision cloud is a view-level graphical annotation that marks a specific area of change and is associated with one revision. Revit separates them because a single design change often affects multiple views across multiple sheets. By linking many clouds to one revision, Revit ensures that every sheet's title block schedule reports the same revision number, date, and description for what is logically a single contractual issuance. Without this separation, each cloud would generate its own schedule entry, creating confusion and undermining the document's legal clarity.

Question 2: BASIC CALCULATION

A project has three revisions defined (Revisions 1, 2, and 3). Revision 1 has clouds on Sheets A101, A102, and A201. Revision 2 has clouds on Sheets A101 and A301. Revision 3 has clouds only on Sheet A201. Using Per Project numbering, list exactly which revision numbers will appear in the revision schedule on each of the four sheets: A101, A102, A201, and A301.
Show answer
Sheet A101 will display Revisions 1 and 2 in its schedule, because clouds from both revisions are placed on views that appear on this sheet. Sheet A102 will display only Revision 1. Sheet A201 will display Revisions 1 and 3. Sheet A301 will display only Revision 2. In Per Project numbering mode, the revision numbers are consistent across all sheets — Revision 2 is always labeled '2' regardless of which sheet it appears on. The schedule on each sheet simply filters the global revision list to show only those revisions whose clouds appear on that sheet's views.

Question 3: INTERMEDIATE

You are managing a set of 20 issued sheets for a museum renovation. The client requests a change that affects the floor plan on Sheet A103. You draw revision clouds on the floor plan view, but upon opening Sheet A103, you notice the revision schedule in the title block does not show the new revision. Identify at least three possible causes for this problem and describe how you would troubleshoot each one.
Show answer
There are several likely causes. First, the revision cloud may have been drawn on the wrong view — if the floor plan on Sheet A103 is 'Floor Plan — Level 1' but you drew the cloud on 'Floor Plan — Level 1 (Copy),' the cloud exists in a view not placed on that sheet. Open the cloud's properties to confirm the hosting view, then check the sheet's viewport to see which view instance is placed. Second, the revision row's Show setting may be set to 'None,' which hides both cloud and tag while removing the entry from the schedule; open Sheet Issues/Revisions and change it to 'Cloud and Tag.' Third, the title block family's revision schedule may not be configured to display the correct fields — open the title block in the Family Editor and verify the revision schedule includes the necessary columns and is not filtered incorrectly. A fourth, less common cause is that the cloud was placed but its sketch was never finished (the user hit Escape instead of Finish), which means no cloud element was actually created.

Question 4: APPLIED

You are preparing a set of construction documents for a 12,000 sq. ft. art gallery. The project has gone through four revisions over six months. The contractor complains that Sheets A101 and A102 are difficult to read because all four sets of revision clouds are visible simultaneously, creating visual clutter over the floor plans. Propose a visibility strategy using Revit's built-in tools that maintains clear documentation while preserving the revision history in the schedules.
Show answer
The optimal strategy uses the Show column in the Sheet Issues/Revisions dialog to progressively reduce older revisions' visual presence. Set Revision 1 (the oldest) to 'None' — its clouds and tags disappear from all sheets, but since it has been issued, its entry remains in the revision schedule tables. Set Revisions 2 and 3 to 'Tag' — their cloud outlines disappear, but the small delta tags remain visible as discreet indicators. Keep Revision 4 (the most recent and current) set to 'Cloud and Tag' so the contractor can immediately see the latest changes. This tiered approach balances legibility with traceability: the full revision history is always readable in the schedule, the most recent changes are prominently marked, and older changes are acknowledged via tags without overwhelming the drawing. Document this visibility strategy in your project's BIM Execution Plan so that all team members follow the same protocol.

Question 5: CRITICAL THINKING

A colleague argues that Revit's Issued status is unnecessarily restrictive — they want to un-issue Revision 2 to add a forgotten cloud to Sheet A202, then re-issue it. Evaluate this approach from both a technical and a professional-practice standpoint. Under what circumstances, if any, might un-issuing a revision be acceptable? What alternative approach would you recommend?
Show answer
Technically, Revit does allow un-issuing a revision in a non-workshared file by unchecking the Issued box, but in a workshared (central model) environment this action can create synchronization conflicts and data integrity risks. From a professional-practice standpoint, un-issuing is problematic because if the sheet was already distributed to the contractor or filed with a building department, any post-issuance modification breaks the chain of custody. The issued document is a contractual record — altering it retroactively could expose the firm to liability, because the contractor may have already priced or built based on the originally issued version. The recommended alternative is to create a new Revision 3 and place additional clouds under that revision, even if the underlying design change is the same as Revision 2. The description can reference the earlier revision for clarity (e.g., 'Supplement to Revision 2 — additional cloud on A202'). The only circumstance where un-issuing might be defensible is in a purely internal workflow where the sheet has not yet been transmitted to any external party — for instance, during an internal QA review before official issuance. Even then, it should be documented in the project's BIM coordination log.

SUMMARY

Lesson Summary

Summary

Revit's revision system provides a structured, auditable method for tracking changes to construction documents after their initial issuance. The workflow begins in the Sheet Issues/Revisions dialog, where you define each revision as a project-level event with a sequence number, date, and description. You then annotate affected views using revision clouds — graphical elements that associate specific areas of change with a particular revision. These clouds automatically feed into revision schedules embedded in each sheet's title block, creating a per-sheet record of which revisions affect that drawing. The Issued status locks clouds to prevent retroactive editing, preserving the integrity of distributed documents.

Key configuration choices include numbering mode (Per Project vs. Per Sheet), which determines whether revision numbers are globally sequential or reset per sheet, and visibility settings (Cloud and Tag, Tag only, or None), which control visual clutter on sheets with many revisions. Mastering this system is essential for any visual arts professional entering architectural, interior, or exhibition design practice, where issued documents carry contractual and legal significance. The revision cloud is not merely a drawing annotation — it is a communication tool that bridges design intent and constructed reality.

Varsity Tutors • Autodesk Revit • Revisions — Manage revision clouds/revision schedules for issued sheets (intro)