Batch Model Info

Batch Model Info scans one or more Revit models and writes structured Excel reports. Use it to audit a folder of deliverables, review open project models, scan selected cloud models, or capture a BIM snapshot for records and handoff.

Getting Started

Find Batch Model Info in the Utilities pulldown on the Amorphous ribbon tab.

Features

Folder scanning - Scan .rvt, .rte, and .rfa files from a folder, with optional subfolder recursion
Open-file scanning - Process documents already open in the current Revit session
Cloud model browsing - Browse accessible hubs, projects, folders, and selected cloud models from inside Revit
Selected-folder cloud loading - Selecting a cloud folder loads Revit models in that folder, with deeper searches kept as an explicit action
Collector selection - Choose which model information categories to gather
Excel reports - Writes one workbook per model plus a consolidated overview workbook
Structured output - Optionally writes report.json for downstream tooling
Live progress log - Streams per-file status while the scan runs
Conservative popup handling - Handles common open-time notices and leaves decision-heavy dialogs visible
Remembered settings - Saves recent folders, collectors, file filters, and include options per user

How to Use

Basic Workflow

Open Utilities and click Batch Model Info
Choose Folder, Open files, or Cloud models
Pick the output folder
Select the collectors you want to run
Click Start
Review the results pane and open the output folder

Source Options

Source	Use It When
Folder	You have a local folder of Revit files to audit
Open files	The target documents are already open in Revit
Cloud models	You need to scan selected cloud models available to the signed-in Revit user

Folder Source

Folder scans can include .rvt, .rte, and .rfa files. Revit backup files are skipped automatically, and files incompatible with the current Revit year are not processed.

Open Files Source

Open-file scans process documents already open in the current Revit session. Use this when you are already working in the files and want to avoid the open and close cycle.

Cloud Models Source

Cloud browsing uses Revit’s in-process model browser and opens selected cloud models directly from their model paths. It does not use APS tokens or Desktop Connector paths.

When you select a cloud folder, Revit models in that folder are loaded into the selectable model list. Use Find RVTs when you intentionally want to search the selected folder and its subfolders.

Collectors

Collectors control which data is gathered. Lightweight collectors are enabled by default, while heavier collectors are left off until you choose them.

Collector Type	Examples
Default collectors	Basic Info, Project Info, Units, Shared Coordinates, Base Points
Model organization	Levels, Grids, Phases, Phase Element Counts, Design Options
Coordination data	Worksets, Linked Files, Views & Sheets
Heavy collectors	Warnings, Rooms / Spaces

User Interface

Settings View

Area	Description
Source	Chooses folder, open files, or cloud models
Output folder	Sets where the report folder will be created
Collectors	Controls which worksheets and data groups are exported
Start	Begins the scan
Cancel	Stops an active scan after the current safe stopping point

Progress View

The progress log streams each file as it is scanned. Keep the window open until the results pane appears.

Results View

The results pane summarizes successful scans, failures, and files that need attention. Click Open Output Folder to inspect the exported reports.

Outputs

Each run writes to a timestamped output folder.

Output	Description
`<ModelName>.xlsx`	One workbook per scanned model, with one worksheet per enabled collector
`_Overview.xlsx`	Consolidated summary of every scanned file
`scan.log`	Human-readable log of the run
`report.json`	Optional structured data for downstream workflows

Batch Model Info automatically handles common nuisance messages during model open, including unresolved references, missing links, missing fonts, coordination review notices, basic worksharing/opening information, and older version notices.

Dialogs that may require a real decision stay visible. When that happens, the current file is marked Needs attention instead of being treated as a hard failure when the scan can continue after you respond.

Options & Settings

Settings are remembered per user under:

%LocalAppData%\Amorphous\Utilities\BatchModelInfo\settings.json

Setting	Description
Last folder	Remembers the last local folder source
Output folder	Remembers the last report destination
Collectors	Remembers which collectors were enabled
File filters	Remembers selected extensions and recursion
Open-file options	Remembers include-links and include-families choices
Recent cloud models	Remembers selected cloud models by Revit cloud GUID

Use Cases

Scenario	Recommended Approach
Deliverable audit	Scan a folder of RVT files and export overview data
Live project review	Scan open files and include links when needed
Cloud project inventory	Select a cloud folder to scan models in that folder, or use Find RVTs for deeper subfolder searches
Warning snapshot	Enable the Warnings collector for a deeper health report
Room/space review	Enable Rooms / Spaces when validating spatial data
Record model state	Save the timestamped output folder with project milestone records

Batch Model Info is most useful when it produces a repeatable record. The goal is not just to open a model and inspect it once, but to leave behind reports another person can review without opening every file again.

Tips & Best Practices

Start with default collectors when you need a quick inventory
Enable heavy collectors only when needed because Warnings and Rooms / Spaces take longer
Use Open files when the target models are already open
Keep scan outputs grouped by date so later audits can be compared
Review Needs attention files before treating a scan as complete
Use cloud recents for models you scan repeatedly
Use Find RVTs only when needed because it searches deeper than the selected folder

Limitations

Limitation	Details
Revit must open files	Folder and cloud scans are limited by Revit’s ability to open each model
Cloud load time	Loading hubs and folders can take time on large accounts, and recursive Find RVTs searches are intentionally deeper
Decision-heavy dialogs	Schema conflicts, recovery prompts, cloud access issues, and unknown dialogs are left for the user
Current Revit year	Files incompatible with the running Revit version are skipped
Collector time varies	Heavy collectors and large models can increase scan time

Troubleshooting

A file is marked Needs attention

Cause: Revit showed a dialog that may require a real user decision.

Solution: Respond to the visible dialog, then review the run log and workbook notes for that file.

A folder scan skips files

Possible causes:

The file extension filter excludes them
They are Revit backup files
They are not compatible with the current Revit version

Solution: Check the selected extensions, current Revit year, and scan.log.

Cloud browsing is slow

Cause: Loading hubs, projects, folders, or recursive cloud searches can take time on large accounts. Selecting a folder loads models in that folder first; Find RVTs searches deeper.

Solution: Browse lazily to the folder you need. Use remembered recent cloud models for repeat scans, and use Find RVTs only when you need subfolder results.

A workbook is missing expected data

Cause: The relevant collector may not have been enabled.

Solution: Re-run the scan with the needed collector checked.

Utilities - Parent menu for focused utility commands
QA Checker - Run model quality checks inside the active document
Data Navigator - Navigate back to elements from exported CSV-style reports