Skip to main content
A Legal Hold report exports a list of all the files currently being held by an active legal hold. To run a Legal Hold report:
  1. Navigate to the Admin Console, then Governance.
  2. Select the Legal Holds tab.
  3. Hover over the relevant Legal Hold then click the Report button.
You can also, from the Admin Console, click into Reports > Create Report > Legal Hold Content, then hover over the relevant Legal Hold and click Report.
NoteLegal hold policy reports contain data up to 48 hours prior to the report being generated. Updates to the report are processed asynchronously. There may, therefore, be temporary discrepancies in the report. If this occurs, wait a short time then run the report again.
  • File format: comma-separated value (.csv) file
  • Filename format:legal_holds_[case name]_run_on_YYYY-MM-DD__HH-MM-SS-[A|P]M_Page_#.csv
  • Folder name format (each report run is placed in its own folder):Legal Holds run on YYYY-MM-DD HH-MM-SS
  • Filename and folder name time zone: the local date and time of the admin who ran the report or who set up the report schedule.
This section describes the data columns that are generated in Legal Holds reports.

​
Assignment Type

Explains what type of assignment placed a file version on hold. Values can be:
  • user - Access
  • user - Interactions
  • user - Ownership
  • folder
  • file
  • file version

​
Assignment ID

A number the uniquely identifies the legal hold assignment.

​
Parent Folder Path

The path from the root of your Box instance to the folder containing the file.

​
Parent Folder Path ID

A number that uniquely identifies the path from the root of your Box instance to the folder containing the file.

​
File Name

The name given to the file.

​
File ID

A number that uniquely identifies the file version put on hold.

​
File Version ID

A number that uniquely identifies the newest version of the file.

​
Created

The date, in UTC, that the file was created.

​
Uploaded

The date, in UTC, that the latest version of the file was uploaded.

​
Size (bytes)

The size of the file in bytes.

​
Owner ID

The value in the Name field in User Account Details of the owner of the file.

​
Reason For Hold

Explanation why a file version was put on hold. Values can be:
  • Owner
  • Collaborator
  • Folder
  • File
  • File Version

​
Trashed

Indicates if the file is in Trash when the report is run. Values can be:
  • Yes
  • No

​
Custodian Email

The email address of the custodian (managed-user).

​
Owner Email

The email address of the file’s owner.