> ## Documentation Index
> Fetch the complete documentation index at: https://docs.box.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retention Report

<div className="article_labels_list" style={{display: 'none'}} dangerouslySetInnerHTML={{__html: "Overview , Reporting , Admin , Article , Account Administration , Established"}} />

[Retention policies](/en/box-governance/retention/about-retention-and-retention-policies) enable you to retain certain types of content in Box for a specified period of time, and remove content from Box that is no longer relevant. A retention report exports details of a particular retention policy, along with a list of all of the files the policy covers. Retention reports do not include files that have already met their retention requirements and been removed.

<Note>
  **Note:** Retention policy reports contain data up to 48 hours prior to the report being generated.
</Note>

## Retention Report details

* **File format**: comma-separated value (.csv) file
* **Filename format**:`data_retention_[policy name]_run_on_YYYY-MM-DD__HH-MM-SS-[A|P]M.csv`
* **Folder name format** (each report run is placed in its own folder):`Retention run on YYYY-MM-DD HH-MM-SS`
* **Filename and folder name time zone**: the local [date and time](/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data) of the admin who ran the report or who set up the report [schedule](/en/box-admin-tools/reporting-and-insights/scheduling-reports).

### Retention report information

Retention reports include details of a particular retention policy, along with a list of all of the files the policy covers.

Retention reports include the following information about the retention policy, in addition to the report's data columns:

<table border="1">
  <thead>
    <tr>
      <th>Retention Policy Information</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Policy Name</td>
      <td>The name of the retention policy.</td>
    </tr>

    <tr>
      <td>Policy Status</td>

      <td>
        <p>The status of the retention policy. Values can be:</p>

        <ul>
          <li>active: The policy is active and retaining the designated files per the policy's configuration.</li>
          <li>retired: The retention policy is not retaining files.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Assignment Type</td>

      <td>
        <p>The content that the policy is applied to, taken from the Apply Policy To setting value. Values can be:</p>

        <ul>
          <li>Folder(s): When <em>Content within specific folders</em> is selected as the policy setting.</li>
          <li>Metadata: When <em>Content with specific metadata</em> is selected as the policy setting.</li>
          <li>All: When <em>All new content</em> is selected as the policy setting.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Retention Type</td>

      <td>
        <p>The <a href="/en/box-governance/retention/about-retention-and-retention-policies#modifiable-and-non-modifiable-retention" target="_self">type of retention policy</a>. Values can be:</p>

        <ul>
          <li>Modifiable</li>
          <li>Non-modifiable</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Policy Time Period</td>

      <td>
        <p>The amount of time content is retained by policy, taken from the Time Period Duration policy setting. The values is the number of days.</p>
      </td>
    </tr>

    <tr>
      <td>Policy Disposition Action</td>

      <td>
        <p>The action taken on files once the policy time period ends, taken from the Disposition Action setting value. Values can be:</p>

        <ul>
          <li>remove\_retention: When <em>None</em> is selected as the policy setting, which means retention will be released on files governed by the policy.</li>
          <li>permanently\_delete: When <em>Permanently delete content</em> is selected as the policy setting, which means files governed by the policy will be irretrievably deleted.</li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Policy Created Date</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC, that the retention policy was created.</td>
    </tr>
  </tbody>
</table>

### Retention report data columns

This section describes the data columns that are generated in Retention reports.

<table border="1">
  <thead>
    <tr>
      <th>Data Column</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Parent Folder Path</td>
      <td>The path from the root of your Box instance to the folder that contains the file.</td>
    </tr>

    <tr>
      <td>Parent Folder Path IDs</td>
      <td>A number that uniquely identifies the parent folder.</td>
    </tr>

    <tr>
      <td>File Name</td>
      <td>The name given to the file.</td>
    </tr>

    <tr>
      <td>File ID</td>
      <td>A number that uniquely identifies the file.</td>
    </tr>

    <tr>
      <td>File Version ID</td>
      <td>A number that uniquely identifies the version of the file.</td>
    </tr>

    <tr>
      <td>Created</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC that the file was created.</td>
    </tr>

    <tr>
      <td>Uploaded</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC that the version of the file was uploaded.</td>
    </tr>

    <tr>
      <td>Disposition Date</td>
      <td>The <a href="/en/box-admin-tools/reporting-and-insights/dates-and-times-in-report-data" target="_self">date</a>, in UTC, on which the policy disposition action will take place for the file.</td>
    </tr>

    <tr>
      <td>Trashed</td>

      <td>
        <p>Indicates if the file is in <a href="/en/box-fundamentals/for-users/staying-organized/managing-files-and-folders/managing-trash" target="_self">Trash</a> when the report is run. Values can be:</p>

        <ul>
          <li>Yes</li>
          <li>No</li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>