Skip to main content
This article is about Box Shuttle in the Admin Console. If you’re using legacy Box Shuttle, a standalone tool, see legacy migration guides.
You can export a report as an Excel (.xlsx) file or as a folder of CSV (.csv) files. Export reports as CSV files when your job is large, because this format supports much bigger reports than a single Excel file. You can generate a report for a running job that has gotten past the Pre-Run Validation step, as well as for any job that has already completed. Additionally, 90 days after a job run, an automatic report is generated and exported to the job report archive.
A recommended size of an Excel report should not exceed 5 million items (paths) in your job. Excel files that exceed this number are several hundred MB in size and are difficult to open and manipulate for most computers. To limit the size of your export, use the filters available in Job History, or export the report as a folder of CSV files instead.

​
Export a report

  1. In the Job Report section, click Export.  If you want to export a report for a past job, go to the report list and click View Job Report.
  2. In the Report Format drop-down list, select Excel or CSV. The default format is Excel.
  3. Select the data you want to include in the report and confirm with Export. Bear in mind the following rules:
    • If the file name exceeds 207 characters, the report name is truncated to comply with this setting. The file name is truncated to 207 characters so it can be opened in Microsoft Excel.
    • All forward and backslashes in the file title are replaced with underscores.
      Export Report screenshot
After that, a confirmation dialog appears, allowing you to open the report to see its contents. You can also close the dialog and return to the report later on. The report is generated and saved to the Box Shuttle Reports folder in Files. This folder is created automatically the first time you run an export to your account, regardless of whether you choose Excel or CSV:
  • If you selected Excel, the report is saved as an .xlsx file.
  • If you selected CSV, the report is saved as a folder of .csv files. Each CSV export has a timestamp, so a new folder is always created for the export.
If you delete the folder, exported reports are lost. If you delete a given report in the folder, that report is lost. The folder is automatically recreated when you export the next report.
Additionally, all exports appear in the Export List tab of the Job Report for 7 days, where you can download them. The exported reports remain in the target user account until they are deleted by the user.
Last modified on July 10, 2026