Skip to main content

This article applies to version 6.

Other available versions:

Version 5 | Version 4icon.qnmark.png

Available in:

Small Business
Code42 Support

Specify version settings

This article applies to version 6.

Other available versions:

Version 5 | Version 4icon.qnmark.png

Available in:

Small Business


The Code42 app keeps multiple versions of each file as the file changes are backed up over time. Version snapshots can be downloaded from an archive to revert to a file's previous state. This tutorial explains how to change your version retention settings.


This article describes how to configure the version retention feature if your administrator has not defined these settings. However, your administrator may configure and lock the version retention settings.

If the version retention settings are locked, they are disabled in the administration console. See your administrator to configure these settings.

How it works

Code42 is designed to keep more of the recent versions of your backed up files and fewer of the older versions.

Specifying the versions to retain involves:

  • Specifying versions to retain for each interval
  • Pruning unnecessary files from the backup archive (optional)
  • Specifying when to compact the backup archive

Backup frequency

The Code42 app backs up new changes to files as often as your backup frequency settings allow. The Code42 app watches the file system in real-time (unless that feature is turned off). When a file changes, the next backup is based on your frequency settings. For example, if the backup frequency is set to 15 minutes, then the changes will back up at the next 15 minute interval.

The Code42 app retains the newest version in several intervals:

  • The last week
  • The last 90 days
  • The last year
  • Previous years

Version retention

Code42 selectively prunes out older file versions during the regular archive-maintenance process. This decreases the amount of data tracked as the archive grows, and it decreases memory usage in the Code42 app. For example, two months from now, you might not need to download a file from 8:45 a.m. when an hourly snapshot would work.

Typically, we do not recommend increasing the frequency or versions settings beyond the default settings. Increasing these settings requires the Code42 app to use more system resources to maintain your backup. Even if you have a small file selection, increasing the version retention can cause a delay in backing up your files due to file monitoring.

Retain a single version of a file
You can tell the Code42 app to only retain a single version of older files. This may be useful if you have large files that change frequently, but for which older versions provide little value. For example:
  • a database
  • Photoshop project file
  • iMovie project file
  • ProTools project file
To only retain a single version of a file, set your retention settings to:
  • Last week: every week
  • Last 90 days: never
  • Previous years: never
Please note that your retention settings apply to every file backed up to particular destination. In other words, if you are backing up to a cloud destination, your version retention settings apply to every file backing up to the cloud destination regardless of the backup set to which a file belongs.

Deleted file retention

If you delete a file from your device that was previously backed up, it remains in the archive for as long as indicated in the deleted files retention setting. Learn more about retaining and restoring deleted files.

Specify versions to retain

Steps for Code42 app version 6.5 and later

Steps for Code42 app versions earlier than 6.5

Remove unwanted versions immediately


  1. Sign in to the Code42 app.
  2. Navigate to device preferences. 
  • Code42 app version 6.8.3 and later: Select settings button Settings.
  • Code42 app version 6.8.2 and earlier: 
    1. Click Details.
    2. Select the arrow next to your device name.
    3. Choose Device preferences.
      device preferences
  1. Click Destinations.
  2. Choose Run Maintenance.
    The Code42 app sends a request to that destination to immediately remove unwanted versions from the backup archive.


The following example displays one possible configuration of the version retention settings:

Frequency and versions example

In this example, the Code42 app retains the most recent file backed up each day in the last week, plus the most recent file backed up each day for the last 90 days (that is, in addition to last weeks' files), plus one version per week for the last year, plus one version per month for the years prior to last year.

In another example, if you choose to retain two versions per week, the Code42 app will retain the most recent version backed up at the end of the week, plus the most recent version backed up three and a half days earlier, in essence splitting the difference.