Retention is part of Box Governance. Box Governance in included in all Enterprise Plus plans and available as a paid add-on to all other business plans.
Retention policies enable you to retain certain content in Box for a specified period of time, and to remove content at end of that specified period of time. At its core, retention ensures content does not get deleted accidentally or intentionally until the content is out of the retention period.
- What End Users See
- Event - Based Retention
- Modifiable and Non-modifiable Retention
- Retention Policy Reporting
- How Retention Interacts with Trash
- Retention Examples
What End Users See
Users can delete retained files by sending them to Trash. However, users cannot purge files from Trash until the files’ retention period has ended. Before that time, users can also restore files from Trash to their original location. If the original location has been deleted, users can choose a new folder in which to restore the files.
When a file is governed by a retention policy, an indicator displays under theDetails section in the righthand navigation. You also see this information by clicking theMore options arrow to the right of the file name and then selectingProperties > General Info .
For folder-based retention, certain actions can modify the retention policy associated to a file.
- If you move a file from a folder with a retention policy to a folder without a retention policy, the file is still governed under the initial retention policy.
- If you move a file carrying a retention policy to a folder with the same retention length, Box preserves the Time Period value and will evaluate the original Disposition Action when the file expires.
- If you move a file carrying a retention policy to a folder with a different retention length, the longer retention expiration date takes precedence over the shorter one.
- If you move a file carrying a retention policy with an indefinite retention length to a folder carrying a retention policy with a finite retention length, the file will be retained based on the date of the file move.
- You cannot transfer a file or folder with a retention policy outside of the enterprise. You also cannot change the folder owner to an external party, or move an individual file to a folder owned by an external user.
- If you copy a file under retention to another folder not associated with any retention, the copy is not retained.
For metadata-based retention, certain actions can modify the retention policy associated to a file.
- If you remove the custom metadata that is carrying a retention policy from a file, the file is still governed by the initial retention policy.
- If you update the custom metadata on a file to a new metadata value with the same retention length, Box preserves the Time Period value and will evaluate the original Disposition Action when the file expires.
- If you update the custom metadata on a file to a new metadata value with a different retention length the longer Time Period value takes precedence over the shorter one.
- If you change the Time Period from one finite value to another finite value (e.g. 3 years to 5 years), the file will be retained based on the upload date of the file to Box.
- If you change the Time Period from indefinite to a finite value, the file will be retained based on the date the Time Period was updated.
- You cannot transfer a file or folder with a retention policy outside of the enterprise. You also cannot change the folder owner to an external party, or move an individual file to a folder owned by an external user.
Finally, if more than one retention policy is actively applied to a file via folder-based retention, metadata-based retention, or both, then one with the longer expiration date takes precedence.
Event-Based Retention
Event-based retention allows Admins and Co-Admins to create policies where retention doesn’t start until a specified business event occurs. For example:
- A company needs to ensure employee records do not get deleted accidentally or intentionally (i.e., retained “indefinitely”) throughout one’s employment; then retain for 3 years after the employee departure. In this scenario, employee departure is the business event.
- A pharmaceutical company needs to collaborate a research study with an external research firm. Per the contractual agreement, the study ends on a certain date, and content needs to be deleted right after that day. In this scenario, study end date is the business event.
Please reach out to your Support or Customer Success, as event-based retention is an advanced capability and may require some design and planning.
Modifiable and Non-modifiable Retention
With Box Governance, you can create both non-modifiable and modifiable retention policies.
Non-modifiable retention policies are designed to allow certain financial services customers to electronically store and retain records in a manner that complies with SEC Rule 17a-4. Once set, non-modifiable retention policies cannot be shortened in duration, and content under retention cannot be removed from active or inactive retention policies.
Not all businesses that want to use retention policies need to comply with the stringent regulatory requirements of SEC Rule 17a-4. Modifiable retention policies allow customers to implement retention policies with the ability to modify them later. This will allow for both the creation and modification of policies, including shortening of retention policies, as well as making policy changes retroactively to content already under retention.
The following table describes the difference between modifiable and non-modifiable retention policies.
| Modifiable Retention Policy | Non-modifiable Retention Policy | |
|---|---|---|
| Designed for SEC Rule 17a-4(f)/FINRA compliance | ❌ | ✅ |
| Add folders | ✅ | ✅ |
| Remove folders | ✅ | ❌ |
| Add metadata | ✅ | ❌ |
| Remove metadata | ✅ | ❌ |
| Lengthen duration | ✅ | ✅ |
| Shorten duration | ✅ | ❌ |
| Retire policy | ✅ | ✅ |
| Delete policy | ✅ | ❌ |
| Change disposition action | ✅ | ✅ |
| Change notification | ✅ | ✅ |
Retention Policy Reporting
Find out how to run a retention policy report in the Admin Console.
How Retention Interacts with Trash
- Trash (if set to either Nobody or Never Delete)
- Retention Policy (with Disposition Action = Permanently Delete Content)
- Trash (any other setting)
File Disposition Upon Retention Expiration
When retention policies require file deletion when the retention period ends, files identified for deletion are normally deleted on the day the retention period ends. There is a rare and unusual situation where this would not happen, and that is because for efficiency purposes, the process to identify file to delete by policy runs once every 14 days.
This would not affect most retention policies because retention is typically measured in years. This disposition identification process can affect the following scenarios:
| Scenario | Result |
|---|---|
| As part of a customer sandbox experiment, you apply a retention policy of one day to a file. | The disposition identification process is run on customer sandboxes daily, so the file is now eligible for deletion after one day elapses. |
| Given a file that is under an Event-Based Retention (EBR) policy of three years, you set the retention start date to exactly three years ago. | The disposition status will be recognized in the next disposition identification process. and the file will be eligible for immediate deletion when the process runs. |
| Given a file that was uploaded to Box five years ago, you apply a retention policy of three years to the file's parent folder. | The disposition status will be recognized in the next disposition identification process. and the file will be eligible for immediate deletion when the process runs. |
Retention Examples
Here are a few customer examples for retention:
- A company needs to retain employee records for 3 years after employee departure.
- A financial institution wants to manage their loan process through Box, retaining the final documents for 6 years for compliance requirements.
- A manufacturing company wants to share reports with vendors through Box, and these reports are only relevant for 30 days.
Retention policies apply to all file versions. That means when a retention policy is applied to a file, it applies to all existing versions of that file as well as to future versions of that file. Here's an example of folder-based or enterprise policy:
- Version 1 of a file has a 7-day retention period
- Version 2 is uploaded 3 days later
The 7-day retention period applies to Version 2, but starts from when Version 2 was uploaded. In other words, Version 2 will be retained for 7 days from the upload date -- 4 days after Version 1 would have been deleted. However, for event-based retention, all versions will have the same expiration date based on the metadata start date set on the file. This is because metadata template is not version specific.
Admins and Co-Admins with explicit permission to manage policies) can create retention policies and can apply those policies:
- At the global (entire enterprise) level (note this option is not retroactive)
- At the folder level
- At the file level (via API only)
- To content with specific metadata
As part of retention policies, you define the retention period and when the retention period starts. Retention periods can start:
- When files are added or uploaded to Box
- On dates defined in or by file metadata (event-based retention)
This makes it easier to properly retain unstructured data and ensure regulatory mandates are met.
Retention policies are available via the Admin Console, API, and Tier 1 SDKs.