Renumber Revit viewport detail numbers by their position on the sheet

Short answer

A Dynamo graph or pyRevit script reads viewport positions on each sheet, groups them into rows and columns, and assigns detail numbers in your grid convention without the 'Detail Number is already in use' error. Start here: define your numbering convention (for example A1 bottom right, by grid cell). Keep a person in the loop: Run on a detached copy first. Check sheet references and callouts after renumbering.

The problem

Renumber Revit viewport detail numbers by their position on the sheet. This is a common, time-consuming task for a bim coordinator.

What this workflow does

How it works: Rules or specialist software perform the task. No AI agent is required.

Your checkpoint: Run on a detached copy first. Check sheet references and callouts after renumbering.

Before you start

Access to the named tool; confirm license, version and cost with the vendor.
A small, non-confidential sample to try the workflow on first.
A qualified person to review the output before it is used.

Tools and access

Follow the steps

Define your numbering convention (for example A1 bottom right, by grid cell).
Collect viewports on the selected sheets and read their box center points.
Group by Y within a tolerance into rows, then sort by X.
Temporarily rename all detail numbers to a unique prefix to avoid conflicts.
Assign final numbers from the sorted order.
Test on a copy of the model and check callouts and references update.

Try a small example

Replace the bracketed fields with your own project details. No tested sample run is published for this workflow yet.

Sample input

Fill in the bracketed [fields] in the text below with your project data.

Manual setup checklist

Write a pyRevit script that renumbers viewports on the selected sheets by position: group into rows by Y center with a [tolerance] tolerance, sort left to right, use a temporary prefix to avoid duplicate detail numbers, then apply [convention].

Expected output

Not published yet. Treat any output as a draft and check it against the source documents.

Check the result

Every value, citation or quantity traces back to a source document.
Missing information is marked as missing, not filled in.

Limits and recovery

Run on a detached copy first. Check sheet references and callouts after renumbering.
Check your organization’s data policy before sharing project files with third-party tools.

Stop or switch when: The source cannot be verified, permissions are missing, or the result contains unsupported facts.

Frequently asked questions

How do I renumber Revit viewport detail numbers by their position on the sheet?

Define your numbering convention (for example A1 bottom right, by grid cell). Collect viewports on the selected sheets and read their box center points. Group by Y within a tolerance into rows, then sort by X. The full step list is above.

Does this use an AI agent or regular software?

It is labeled Conventional automation: Rules or specialist software perform the task. No AI agent is required.

What tools do I need?

Dynamo, pyRevit. Confirm license, version and cost with the vendor, and try it on a small non-confidential sample first.

Can I use the output without checking it?

No. Run on a detached copy first. Check sheet references and callouts after renumbering.

Has this workflow been tested?

Workflow guide · not independently tested. It is written from vendor documentation and practitioner use.

Evidence and maintenance

Written from vendor documentation and practitioner use. Labels apply to the steps described here, not every feature of a product. Links were checked when the page was written.