Revit Upgrade Troubleshooting¶
Use the following checks if Revit Upgrade cannot process selected content or an upgrade cannot be completed.
Revit Upgrade Is Not Available¶
Revit Upgrade is available only in Revit 2027.
If the command is not available, confirm that you are running Revit 2027 and the corresponding version of Flow.
Revit 2027 only
Revit Upgrade is not available in earlier supported Revit versions.
Quick Upgrade Will Not Start¶
Quick Upgrade requires all selected files to be located in the same folder.
If Flow reports:
All selected files must be in the same folder.
check the selected files and try again.
If files need to be processed from several folders, use:
Batch Upgrade (folder + subfolders)
instead.
No Supported Files Were Found¶
Batch Upgrade searches the selected folder and its subfolders for supported content.
If Flow reports:
No supported files found.
check that:
- The correct root folder was selected.
- The required content exists beneath that folder.
- The files use a supported file type.
- The required files are not numbered Revit backup files.
- The files are not already inside a NewFiles output folder.
Existing NewFiles folders are deliberately excluded from Batch Upgrade discovery.
The main verified workflow includes RVT, RFA and RTE Revit content together with PNG and TXT supporting files.
A Revit File Cannot Be Opened¶
Flow first attempts to open standard Revit content normally.
If that fails, it makes another attempt using Revit's Audit option.
If both attempts fail, the file is recorded as failed and processing continues with the remaining files where possible.
Use View Last Batch Summary after processing to review the available error information.
Some Files Succeed and Others Fail¶
An individual file failure does not normally stop the remaining files from being attempted.
After the batch has finished:
- Open Revit Upgrade.
- Select Batch Upgrade (folder + subfolders).
- Select View Last Batch Summary.
- Review the failed files and available error information.
Correct the source issue where possible before retrying unsuccessful files.
Suspected Failed Files¶
Some batch problems occur at the Revit worker-process level rather than producing a definite failure for one individual file.
If Flow cannot confidently obtain a complete result from a group processed through Revit, the affected files can be marked as:
suspected failed
This can occur when the Revit worker does not complete normally or does not return a usable result.
A suspected failure does not automatically mean that the source file itself is corrupt.
Use Retry Failed Files from Last Batch to process these files again.
Current summary limitation
View Last Batch Summary currently lists normal failed files but does not separately show suspected-failed files.
Retry can therefore contain more files than are shown under Failed in the summary.
Retry Failed Files¶
Batch Upgrade can create a new job containing unsuccessful files from the recorded previous batch.
To retry them:
- Open Revit Upgrade.
- Select Batch Upgrade (folder + subfolders).
- Select Retry Failed Files from Last Batch.
Flow includes files that were recorded as:
- Failed
- Suspected failed
and starts a new upgrade job using the original source and output locations.
If there are no applicable files to retry, Flow reports:
No failed files found.
The Last Batch Summary Still Shows the Original Batch After a Retry¶
The current retry workflow creates a separate retry job but does not replace the recorded new batch used by:
View Last Batch Summary
As a result, opening the Last Batch Summary after starting a retry can continue to show the original batch rather than the retry result.
This is expected with the current implementation.
No Previous Batch Run Was Found¶
View Last Batch Summary and Retry Failed Files from Last Batch rely on information recorded from the most recent new batch.
If Flow reports:
No previous batch run was found.
run a new Batch Upgrade first.
The Last Batch Summary Cannot Be Displayed¶
The last batch summary depends on the result information generated by the recorded batch.
The summary may not be available if:
- The previous result file cannot be found.
- The last-run information is incomplete.
- The result file cannot be read.
Run a new batch if the previous batch information is no longer available.
BatchRunner.exe Was Not Found¶
Revit Upgrade uses Flow's external batch processor to perform the upgrade.
If Flow reports:
BatchRunner.exe was not found.
the required Flow Batch Runner is missing from the expected installation location.
The upgrade job may have been created, but processing cannot start until the Flow installation is corrected.
Restart Revit after the Flow installation has been repaired or updated, then run Revit Upgrade again.
An Output File Already Exists¶
Revit Upgrade writes processed content beneath the NewFiles folder.
If a corresponding output file already exists, Flow replaces that output with the newly processed version.
The original source file is not replaced.
NewFiles may contain previous output
Running the upgrade again can replace files from an earlier run beneath NewFiles.
If previous upgraded output needs to be retained, move or copy it to another location before running the upgrade again.
Supporting PNG or TXT Files Have Not Changed¶
This is expected.
PNG and TXT files are supporting content rather than Revit documents.
Flow copies these files to the corresponding location beneath NewFiles without modifying their contents.
Existing output copies can be replaced when the upgrade is run again.
Revit Backup Files Are Missing¶
This is expected.
Numbered Revit backup files are:
- Excluded from Batch Upgrade when source content is collected.
- Removed from the NewFiles output after processing.
Revit Upgrade is intended to produce a clean upgraded output rather than reproduce numbered Revit backup files.
A Template Produces an RVT File¶
Revit project templates are processed differently from standard Revit files.
Flow first creates an upgraded RVT representation and then attempts to save the document as an RTE template.
If the RTE save succeeds, the intermediate RVT is removed.
If the RTE save cannot be completed, the RVT may remain as the available upgraded output.
Review the affected template before using it in the Revit 2027 content library.
Purge Unused Could Not Be Completed¶
Flow attempts to purge unused content while upgrading applicable Revit files.
A purge problem does not necessarily mean that the entire upgrade has failed.
Where possible, Flow continues with the upgrade and records the purge issue separately.
Review the resulting file in Revit 2027 before adding it to the production library.
I Cannot Cancel a Batch That Has Already Started¶
The file, folder and action dialogs can be cancelled before an upgrade job is launched.
Once the external Batch Upgrade process has started, the current workflow does not provide a Flow Cancel button.
Allow the batch process to finish before reviewing its result.
Reporting a Problem¶
If the problem continues, record:
- The source file or folder being processed.
- Whether Quick Upgrade or Batch Upgrade was used.
- What you expected to happen.
- What happened instead.
- Any error information shown in View Last Batch Summary.
- Whether Retry Failed Files included additional files.
- A screenshot of the message or summary where useful.
For Batch Upgrade problems, the failed filename and source path shown in the summary can help identify affected content.