Skip to content

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:

  1. The correct root folder was selected.
  2. The required content exists beneath that folder.
  3. The files use a supported file type.
  4. The required files are not numbered Revit backup files.
  5. The files are not already inside a NewFiles output folder.

Existing NewFiles folders are deliberately excluded from Batch Upgrade discovery.

A Revit File Cannot Be Opened

Flow first attempts to open 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.

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 stop the remaining files from being attempted.

After the batch has finished:

  1. Open Revit Upgrade.
  2. Select Batch Upgrade (folder + subfolders).
  3. Select View Last Batch Summary.
  4. Review the failed files and available error information.

Correct the source issue where possible before retrying the failed files.

Retry Failed Files

Batch Upgrade can create a new job containing the files that failed during the previous batch.

To retry them:

  1. Open Revit Upgrade.
  2. Select Batch Upgrade (folder + subfolders).
  3. Select Retry Failed Files from Last Batch.

Flow uses the previous batch information to identify the affected files and starts a new upgrade job for those files.

If there are no failed files to retry, Flow reports:

No failed files found.

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 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 previous 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 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 file 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.

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.

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.
  • A screenshot of the message or summary where useful.

For Batch Upgrade problems, the failed filename and source path shown in the last batch summary can help identify the affected content.