<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "FinderSync",
  "identifier" : "/documentation/FinderSync",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Finder Sync"
    ],
    "preciseIdentifier" : "FinderSync"
  },
  "title" : "Finder Sync"
}
-->

# Finder Sync

Modify the Finder’s user interface to express file synchronization and control.

## Overview

Use Finder Sync to cleanly and safely modify the Finder’s user interface to express file synchronization status and control. Unlike most extension points, Finder Sync doesn’t add features to a host app. Instead, it lets you modify the behavior of the Finder itself.

Use this framework when you need to synchronize the contents of a local folder with a remote data source. Then provide visual feedback to the Finder by extending the [`FIFinderSync`](/documentation/FinderSync/FIFinderSync-swift.class) class and overriding appearance methods defined within the [`FIFinderSyncProtocol`](/documentation/FinderSync/FIFinderSyncProtocol) protocol.

To learn more about creating a Finder Sync extension, see [Finder Sync](https://developer.apple.com/library/archive/documentation/General/Conceptual/ExtensibilityPG/Finder.html#//apple_ref/doc/uid/TP40014214-CH15) in [App Extension Programming Guide](https://developer.apple.com/library/archive/documentation/General/Conceptual/ExtensibilityPG/index.html#//apple_ref/doc/uid/TP40014214).

## Topics

### Classes

[`FIFinderSync`](/documentation/FinderSync/FIFinderSync-swift.class)

A type to subclass to add badges, custom shortcut menus, and toolbar buttons to the Finder.

[`FIFinderSyncController`](/documentation/FinderSync/FIFinderSyncController)

A controller that acts as a bridge between your Finder Sync extension and the Finder itself.

### Protocols

[`FIFinderSyncProtocol`](/documentation/FinderSync/FIFinderSyncProtocol)

The group of methods to implement for modifying the Finder user interface to express file synchronization status and control.

### Reference

[FinderSync Enumerations](/documentation/FinderSync/FinderSyncEnumerations)

 

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)