How to Add Revisions in Revit

Seven steps in Revit, or one sentence in Mira.

Do it with Mira
Quick answer

Click View tab › Sheet Composition panel › Sheet Issues/Revisions, click Add and enter the date and description. Draw a cloud with Annotate tab › Detail panel › Revision Cloud, set its Revision in Properties and tag it. The sheet then lists it.

Or, just ask Mira, a free add-in, to add a revision to a range of sheets.

The manual way

How to do it in Revit

  1. Step 1: Decide how clouds are numbered

    Click View tab › Sheet Composition panel › Sheet Issues/Revisions and set the cloud Numbering to Per Project or Per Sheet before you add anything. Changing it later can renumber every cloud (Autodesk Help: Specify Revision Cloud Numbering by Project or by Sheet).

  2. Step 2: Add the revision

    In the same dialog, click Add; for the project's first revision, fill in the default row instead. Set the row's Numbering (Numeric, Alphanumeric or None), Date and Description, which is what the sheets' revision schedules print (Autodesk Help: Enter Revision Information).

  3. Step 3: Draw the revision cloud

    Open the view that changed and click Annotate tab › Detail panel › Revision Cloud. Sketch around the change with a draw tool, press the spacebar to flip the arcs, and click Finish Edit Mode (Autodesk Help: Add a Revision Cloud). Clouds work in any view except 3D.

  4. Step 4: Assign the right revision

    A new cloud takes the latest revision on its view's sheet. To change it, select the cloud and pick another Revision in the Properties palette.

  5. Step 5: Tag the cloud

    Click Annotate tab › Tag panel › Tag by Category (TG) and click each cloud. The tag shows the revision number; a project started from the default template already has the Revision Tag family loaded.

  6. Step 6: Add a revision to sheets without clouds

    Select one or more sheets in the Project Browser, click Edit next to Revisions on Sheet in the Properties palette, and check Shown in Revision Schedule for the revision (Autodesk Help: Specify the Revisions to Include in a Revision Schedule). Revisions that come from clouds on a sheet are already checked and locked.

  7. Step 7: Issue it

    When the set goes out, fill in Issued to and Issued by and check Issued. Revit then locks that row and its clouds, and you can't assign the revision to new clouds; clear Issued to make a change.

What to watch for

Reordering renumbers. Move Up and Move Down in Sheet Issues/Revisions change the sequence, and every tag and revision schedule renumbers to match. Merge Up and Merge Down combine two rows and discard the merged row's date and description.

Deleting a revision deletes its clouds. Delete removes the revision along with every cloud and tag assigned to it. An issued revision can't be deleted, and a project always keeps at least one.

Hide a cloud without losing the revision. Set the revision's Show to None or Tag, or hide the Revision Clouds category in the view, and the revision stays in the schedule. Hide in View › Elements, or cropping the cloud out, drops it. More in how to hide and unhide elements.

Change cloud color for the whole project. In Manage tab › Settings panel › Object Styles, set Revision Clouds on the Annotation Objects tab. For one cloud, right-click it and use Override Graphics in View › By Element.

The schedule lives in the title block. A sheet lists revisions only if its title block has a revision schedule. See how to create a title block to add one.

Revisions pile up across the set. An addendum can touch forty sheets, and each one needs the revision added, a cloud drawn and the schedule checked before it goes out. A missed sheet prints the wrong revision history, and nothing flags it until a contractor asks. That checking across sheets is the kind of repetitive work an AI agent for Revit can take on, with you approving each change.

Or, just ask Mira to do it.

Mira is an AI thinking partner for Revit that automates the work you repeat and builds tools your team needs.

  • Type this in Mira

    Add Revision 3 to sheets A-101 through A-110.

    Mira reads Sheet Issues/Revisions to confirm which revision is 3, says which sheets already show it through clouds, and asks before adding it to the rest. It writes a small tool to add it, which asks Allow first, and reads each sheet back; one Ctrl+Z undoes it.

EfficiencyAdd a revision to many sheets in Revit
Riverside_Medical_Center_ARCH.rvt — A-101
FileArchitectureStructureAnnotateAnalyzeViewManagePirros
A-101 ×A-501 Details3D View
A-101added
A-102added
A-103by cloud
A-104added
A-105added
A-106added
A-107by cloud
A-108added
A-109added
A-110added
10 sheets show Revision 3
Mira by PirrosA-101
Pirros
ChatSkillsHistory
Add Revision 3 to sheets A-101 through A-110.
Reasoning
Thought for 4s
ReadRevisions(Sheet Issues/Revisions)
Rev 3: Owner Review
Plan(Add to 8, skip 2)
Approved
AddRevision(8 sheets)
Added, read back
Revision added8 sheets
Added
8 sheets
Already shown
2, by cloud
Revision
3, Owner Review
Clouds drawn
0
Message Mira
Mira can make mistakes. Verify before you commit.
FAQ

Frequently asked questions.

Can't find what you're looking for?
Get in touch.

Click View tab › Sheet Composition panel › Sheet Issues/Revisions, click Add and enter the date and description. Then draw a revision cloud in the changed view, assign that revision to it and tag it.

Open the view, click Annotate tab › Detail panel › Revision Cloud, sketch around the change and click Finish Edit Mode. Select the cloud to set its Revision in the Properties palette.

Open Sheet Issues/Revisions and change the row's date, description or numbering. If the revision is marked Issued, clear Issued first, make the change, then select Issued again.

Revision numbers follow the order of rows in Sheet Issues/Revisions and each row's numbering scheme. Move a row up or down to renumber, change its Numbering to Numeric, Alphanumeric or None, or set up a custom sequence under Customize Numbering.

For every cloud, open Manage tab › Settings panel › Object Styles and change Revision Clouds on the Annotation Objects tab. For one cloud, right-click it and choose Override Graphics in View › By Element.

Select the sheet, click Edit next to Revisions on Sheet in the Properties palette and check Shown in Revision Schedule for that revision. Select several sheets in the Project Browser first to add it to all of them.

Two ways in

Try it yourself.
Or bring it to the firm.

The download is free and takes a minute. The firm conversation is where your standards, your library, and your rollout get built. Start wherever makes sense.

Talk to us about your firm