01 / 24
R

Revisions in
Autodesk Revit

Master revision clouds, revision schedules, and the process of issuing sheets: the essential BIM documentation workflow.

Autodesk Revit BIM Documentation

What Are Revisions?

In construction documentation, a revision is a formal change made to a previously issued drawing set. Revit tracks these changes so every stakeholder knows what changed, when it changed, and why.

The Three Pillars of Revit Revisions

Revision Entry
A row in the Sheet Issues/Revisions dialog that defines the sequence, date, description, and numbering.
Revision Cloud
An annotation element drawn on a view to visually mark where the change occurred on the sheet.
Revision Schedule
A built-in schedule on each title block that lists all revisions associated with that sheet.

Why Revisions Matter

Revisions are not just bookkeeping: they are a legal record of design changes. In the AEC industry, accurate revision tracking can prevent costly construction errors and contractual disputes.

1
Accountability: Every change is dated and described so teams know who authorized what.
2
Clarity: Clouds highlight exact areas of change so contractors don't miss updates.
3
Compliance: Many building departments require a revision history on every issued sheet.

The Revision Workflow

1. Create Revision Entry 2. Draw Revision Clouds 3. Tag Revision Clouds 4. Issue the Sheet Sheet Issues/Revisions Dialog View tab → Sheet Issues/Revisions Add rows, set numbering, dates, descriptions Revision Cloud Tool Annotate tab → Revision Cloud Sketch around changed area, assign revision Revision schedule on title block updates automatically

Creating Revision Entries

1
Open the dialog: Go to View tab → Sheet Issues/Revisions.
2
Add a row: Click "Add" to create a new revision. Each row gets an automatic sequence number.
3
Fill in details: Set the Date, Description (e.g., "Updated egress layout"), and choose Numbering (numeric or alphabetic).
4
Set visibility: Choose whether clouds for this revision appear as Cloud and Tag, Tag Only, or None.

Numbering: Per Project vs Per Sheet

Per Project
All sheets share one global sequence: Revision 1, 2, 3... Best for small projects where every sheet gets every revision.
Per Sheet
Each sheet counts its own revisions independently. Sheet A101 might be on Revision 3 while A102 is on Revision 1. Best for large projects.

Drawing Revision Clouds

TITLE BLOCK Rev Schedule Here REV 1 Cloud marks changed area Tag identifies revision

Cloud Properties and Tags

Every revision cloud has key properties you can control:

Revision
Which revision entry this cloud belongs to. Select from the dropdown in Properties.
Comments
Text description of the specific change, e.g., "Door relocated per client request."
Mark
A short identifier displayed on the cloud tag (often a number like "1" or letter like "A").

The Revision Schedule on Title Blocks

REVISION SCHEDULE REV DATE DESCRIPTION ISSUED 1 01/15/25 Updated egress layout Yes 2 02/10/25 Revised mechanical shaft Yes 3 03/01/25 Structural column added No This schedule auto-populates from revision entries assigned to the sheet

Issuing a Sheet

When you issue a revision, Revit locks its clouds so they cannot be moved, deleted, or edited. This preserves the legal record of what was issued.

1
Open Sheet Issues/Revisions dialog (View tab).
2
Check the "Issued" box next to the revision you want to lock.
3
All clouds for that revision become read-only across every sheet.
4
To make further changes, create a new revision entry and draw new clouds.

Cloud Visibility Options

Each revision entry has a visibility dropdown that controls how its clouds render on sheets:

Cloud and Tag
Both the wavy cloud outline and the revision tag are visible. Use for current/active revisions.
Tag Only
Hides the cloud but keeps the tag. Use when clouds from older revisions clutter the drawing.
None
Hides both cloud and tag. The revision still appears in the schedule but has no visual markers on the sheet.

How to Apply: Full Workflow

1
Make the design change in the model (move a wall, add a door, etc.).
2
Create a revision entry in Sheet Issues/Revisions if one doesn't exist for this round of changes.
3
Draw revision clouds on each affected view, encircling the changed area.
4
Assign the correct revision in the cloud's Properties palette.
5
Tag the clouds using Annotate → Tag by Category.
6
Verify the title block revision schedule shows the correct entries.
7
Issue the revision by checking the "Issued" checkbox to lock it.

Example 1: Simple Door Relocation

A client requests that a door on sheet A101 be moved 3 feet to the east. Here's how we handle the revision:

OLD NEW 3 ft REV 1 Revision Entry Seq: 1 Date: 01/15/25 Desc: Door relocated Issued: Yes

Example 2: Multiple Clouds, One Revision

A structural engineer adds two new columns to a floor plan. Both changes belong to Revision 2, so we draw two separate clouds assigned to the same revision entry.

REV 2a REV 2b Key Point 2 clouds 1 revision Same entry

Example 3: Issued Revision + New Changes

After issuing Revision 1, the client requests another change. You cannot edit the existing clouds because they are locked. Instead:

1
Create Revision 2 as a new row in Sheet Issues/Revisions.
2
Draw new clouds around the new changes and assign them to Revision 2.
3
Set Revision 1's visibility to "None" or "Tag Only" to reduce clutter.
4
Issue Revision 2 when ready. The schedule now shows both rows.

Common Mistakes

✕ Forgetting to Issue
Drawing clouds but never checking "Issued" leaves revisions unlocked. Anyone can accidentally edit or delete them.
✕ Wrong Revision Assignment
Clouds default to the most recent revision. If you forget to change the assignment, the cloud lands on the wrong revision entry.
✕ Overcrowding with Clouds
Leaving old revision clouds visible on sheets makes drawings hard to read. Use "Tag Only" or "None" for past revisions.
✕ Skipping the Tag
Clouds without tags force readers to guess which revision a change belongs to. Always tag your clouds.

Revision Quick Reference

Feature Before Issuing After Issuing
Edit Clouds ✓ Fully editable ✕ Locked / Read-only
Delete Clouds ✓ Can delete ✕ Cannot delete
Add New Clouds ✓ To this revision Must use new revision
Change Visibility ✓ Cloud+Tag / Tag / None ✓ Still adjustable
Schedule Entry Shows with current data Permanently recorded
Un-issue N/A Possible but risky

Key Takeaways

1
Revision entries define the metadata: sequence, date, description, and numbering mode.
2
Revision clouds are annotations that mark where changes occurred on the drawing.
3
Tags connect clouds to their revision entry so readers can identify each change.
4
Issuing locks all clouds for that revision, creating a permanent legal record.
5
Visibility settings let you show or hide old clouds without deleting them.

Question 1 of 5

Where do you create a new revision entry in Autodesk Revit?

Question 2 of 5

What happens to revision clouds after a revision is issued?

Question 3 of 5

If you need to reduce visual clutter from old revision clouds while keeping the revision in the schedule, what should you do?

Question 4 of 5

In the "Per Sheet" numbering mode, how are revision numbers assigned?

Question 5 of 5

You draw three revision clouds on different views of the same sheet, all assigned to Revision 2. How many rows will appear in the title block's revision schedule for Revision 2?