156 Get File Details

Overview

The Get File Details tool instantly displays comprehensive information about the current Revit file — including local paths, cloud collaboration paths, and unique GUIDs. This is especially useful for BIM 360/ACC cloud projects where files are referenced by GUIDs rather than traditional file names.

Table of Contents

• Key Features
• Requirements
• Running the Tool
• Tips and Best Practices
• Common Use Cases
• Troubleshooting

Key Features

• Displays full file path, title, file name, and Revit version
• Shows BIM 360/ACC cloud collaboration paths
• Reveals Project GUID and File GUID for cloud-workshared files
• Formats cloud paths in both BIM 360 and C4R (CLD://) notation
• No configuration required — runs instantly with a single click
• Output written to the Revit Output Dialog for easy copying

Requirements

• Any saved Revit project file (local, network, or cloud)
• Unsaved new files will return limited information — save first for complete output
• Cloud GUID information only appears for BIM 360/ACC workshared files

Running the Tool

Find Get File Details on the Bonus Tools Ribbon or use 115 Search Tools.

Output is displayed in a Revit message dialog and simultaneously written to the Revit Output Dialog (the panel accessible via the Revit Add-Ins output window), which is the easiest place to select and copy the text.

Output fields

Basic information

Document details

Cloud collaboration information (BIM 360/ACC files only)

Tips and Best Practices

• Copy from the Output Dialog. The Revit message box can be fiddly to select text from. The same output is written to the Output Dialog (Add-Ins panel) where it's much easier to copy.
• GUIDs are permanent. A file's GUID stays constant even if it's renamed — making it a reliable identifier for API integrations and external databases.
• Project GUID vs File GUID. The Project GUID identifies the BIM 360/ACC project; the File GUID identifies this specific file within that project. Both are needed for API access.
• C4R Path Name is the API format. If you're developing automation or scripts that open cloud files, the CLD://{ProjectGUID}path/{FileGUID}file.rvt format is what you need.
• Run after any cloud restructure. If files are moved or the cloud project is reorganised, re-run the tool to confirm paths and GUIDs are still as expected.
• Include in project handover docs. Recording the Project GUID and File GUIDs at handover gives future teams a reliable reference even if folder structures change.

Common Use Cases

Locating a cloud file by GUID — BIM 360/ACC stores files using GUIDs internally. If you need to find or reference a file outside of Revit (in a portal, script, or database), run this tool to retrieve the exact identifiers.

API and automation development — Copy the C4R Path Name to get a working example of the GUID-based path format required for programmatic file access via the Revit API or Autodesk Platform Services.

Version compatibility checking — Confirm the Revit version a file was last saved in before sharing with team members or consultants, to avoid "file saved in newer version" errors.

Support requests — When logging a support ticket about a cloud file, run the tool and paste the full output. It gives support staff everything they need to identify the file without any back-and-forth.

Migration audit — Run the tool before and after migrating files between BIM 360 projects. Compare the outputs to confirm paths and GUIDs have updated correctly.

Troubleshooting

No cloud information appears (BIM A360 Path and GUIDs are blank) The file is not a cloud-workshared file, or it has been detached from the central model. Open the file directly from BIM 360/ACC rather than from a local copy to retrieve cloud details.

Output shows limited or no information The file has not been saved yet. Save the file first — unsaved files have no established path for the tool to read.

GUIDs don't match what's shown in the Autodesk portal Verify you are looking at the correct file in the portal. A detached or copied file will have a different GUID. The portal may also display a folder GUID rather than the file GUID — check you are comparing like for like.

C4R Path Name format doesn't work in API code Ensure curly braces {} are included around both GUIDs, there are no hidden characters from copy/paste, and the format exactly matches CLD://{ProjectGUID}FolderPath/{FileGUID}FileName.rvt.

Revit version shown is unexpected The version displayed is the version that last saved the file, not necessarily the version you are currently running. A file opened and re-saved in a newer version will update this value.