Understand Box reports

When you conduct a scan of your Box data, you have the option of generating all or some of these reports. Learn more about how to create a scan

Once the scan is complete, you can view the scan summary and download the reports. For details, see Analyze your scan.  

Click below to learn more about each report.

Box reports you can generate

Open all   |   Close all

Permissions by user

Provides a total count of permissions for each user. 

Field name Description
Email User's email address
Total Number of permissions owned by the user
Depth report

Provides information about the level of hierarchy and location of each scanned folder and the strings required to map deeply nested folders to a specified location in a folder hierarchy.

How to modify

  • Minimum depth—The minimum depth for an item to be included in the report. 
  • Maximum depth—The maximum depth for an item to be included in the report. If you specify 0 (the default), all folders below the minimum depth are included. 
  • Check the Enumerate children box to show the number of items within each folder.
Field name Description
Depth Level of hierarchy of each specified location
Path Path to the location of the object
User Name of the user account
Child Box folders Number of folders located under the object
Child Box files Number of files located under the object
Child Box notes Number of notes located under the object
Child Box collaborations Number of collaborations located under the object
Child Box collaboration set Number of collaboration sets under the object (the number of descendant objects that can be shared)
Total children Total number of child objects under the object
Total size (bytes) Total size of all files under the object, in bytes
Total size Total size of all files under the object
Shared drives candidate report

Gives information on the hierarchical depth of folders and the permissions held by objects within the folders.

There are limits to the amount and type of data you can migrate to shared drives. Use the information in this report to help you assess whether the folders are good candidates for migration to shared drives or whether you should reorganize the data to avoid potential migration issues. Go to Shared drive limits.

How to modify

Provide a value for:

  • Minimum object count—Minimum number of objects (folders and files) inside the folder (default value is 100). The scan excludes folders containing fewer than the specified number. 
  • Minimum shared with—Minimum number of users that have access to the root folder (default value is 5). The scan excludes folders that are shared with fewer users than the number specified.
  • % allowed with additional permissions—Percentage of the content of a folder that is permitted to have additional permissions (default is 15%). The scan excludes folders that have a higher percentage of additional permissions. Go to Additional permissions.
  • % allowed with restricted permissions—Percentage of the content of a folder that is permitted to have restricted permissions (default is 1%). The scan excludes folders that have a higher percentage of restricted permissions. Go to Restricted permissions

Note: The report only includes scanned items that meet all of the conditions above.

Field name Description
Name Folder name
Owner Owner of the folder
Total Total number of objects (folders and files) in the folder and in its hierarchy, including in its subfolders
Folder depth Level of hierarchy of each object
Shared with count How many users or groups the folder is shared with
Path Folder path to the location of the object
ID Unique identifier of the folder
Total folders Number of folders within the folder
Folders with additional permissions Number of folders within the folder that have additional permissions
% folders with additional permissions Percentage of folders within the folder that have additional permissions
Total files Count of all files (not folders) in all folders and subfolders under the candidate (doesn’t discriminate by permissions)
Files with additional permissions Number of files within the folder that have additional permissions
% files with additional permissions Percentage of files and folders within the folder that have additional permissions
Total objects with additional permissions Total number of files and folders within the folder that have restricted permissions
% total objects with additional permissions Percentage of files and folders within the folder that have additional permissions
Box note

Lists the Box Notes. 

Note: G Suite Migrate doesn’t support Box Notes migration.

Field name Description
User User's email address
ID Unique identifier of the note
Title Title of the note
Path  Path of the note
Link URL of the note
Report errors

Identifies any failures such as a failure to connect to a particular user account.

Field name Description
Source Source environment
Title Title of the error
Location Location of the failed object
Type Type of object
Message Error message associated with the failure
Permissions by object

Lists the users that have permissions for the specified files or folders.

How to modify

  • Report folder information—Includes folder information in the report.
  • Report file information—Includes file information in the report.
Field name Description
User User's email address
ID Unique identifier of the object
Path Path to the object
Title Title of the object
Total Number of users who have permissions over the object
Box object totals

Lists the total number of Box objects to be migrated for each user. 

Field name Description
User User's email address
Box folders Number of Box folders owned by the user
Box files Number of Box files owned by the user
Box collaborations Number of Box collaborations owned by the user
Box collaboration set Number of Box collaboration sets owned by the user
Total Total number of Box objects owned by the user

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.