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

Understand and troubleshoot backing up with Mac Spotlight

This article applies to version 6.

Other available versions:

Version 5 | Version 4icon.qnmark.png

Available in:

Small Business


The Code42 app uses the Spotlight service on Mac to monitor your computer for file changes. This article describes:

  • The technical details about how Code42 app and Spotlight work together
  • Recommended solutions for errors associated with Spotlight

How the Code42 app uses Spotlight

At a high-level, here's how the Code42 app coordinates with Spotlight to back up your new or changed files:

  1. The Code42 app starts to back up.
  2. The Code42 app requests a snapshot from Spotlight for all local drives.
  3. Spotlight creates a snapshot containing information on all new or changed files.
  4. Spotlight provides the Code42 app with details to access the new snapshot.
  5. The Code42 app backs up ALL files using the snapshot until it reaches a file that has changed since the snapshot was created or the backup session finishes.

This process repeats when Spotlight reports data in your file selection has changed.

Diagnose problems with Spotlight

If your backup never reaches 100%, or you see the message "unable to back up n files" in your History.log file, you can check your logs to find the files that are not backing up

The reason may be due to one of the following Spotlight-related problems:

Recommended solutions

Unable to back up files due to restricted permissions

The Code42 app cannot back up files or folders that have restricted permissions and display a red circle in the Finder. You can either prevent Code42 app from trying to back up the files by modifying your file selection, or you can perform the following steps to change permissions on the files to allow the Code42 app read/write access:

  1. In Finder, select the folder you want to update.
  2. Choose File > Get Info.


  1. Click the triangle next to Sharing & Permissions to expand the section.
  2. Click the lock icon to allow editing of your settings.
  3. When prompted, enter your password to allow changes to the Finder.
  4. Next to everyone, click No Access to display privilege options.
  5. Select Read & Write.

Read & Write Access

  1. Click the gear icon, then select Apply to enclosed items to apply the setting to enclosed subfolders and files.
    Click OK when prompted to confirm the change.

Apply to enclosed items

  1. Click the lock icon again to prevent future changes.

Code42 app is unaware of file changes

Because the Code42 app uses Spotlight to detect file changes, the Code42 app real-time file watch feature cannot detect any new or changed files in your file selection if Spotlight does not report the changes to the files. Confirm that Spotlight is reporting file changes:

  1. Manually start the file verification process in the Code42 app by selecting Scan for file changes.
  2. If you notice that new files are not being detected and backed up by the Code42 app, it could be that Spotlight has not indexed the files. Re-index Spotlight by following the steps outlined in this Apple support article.