<!--
{
  "documentType" : "article",
  "framework" : "Updates",
  "identifier" : "/documentation/Updates/FileProvider",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "File Provider updates"
}
-->

# File Provider updates

Learn about important changes to File Provider.

## Overview

Browse notable changes in <doc://com.apple.documentation/documentation/FileProvider>.

## June 2024

- Offer people the ability to sync their Desktop and Documents folders with your File Provider app. Check whether a person opts in to sync these folders using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderDomain/replicatedKnownFolders>. Sync the folders using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderManager/claimKnownFolders(_:localizedReason:completionHandler:)>, or stop syncing using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderManager/releaseKnownFolders(_:localizedReason:completionHandler:)> if the person opts out. Provide the system with information about which folders you support syncing through <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderDomain/supportedKnownFolders>, and share the locations of the folders by adopting <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderKnownFolderSupporting>.
- Cache files on external disks. Confirm whether a volume is eligible for storing a domain using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderManager/checkDomainsCanBeStoredOnVolume(at:)>, and create a domain on that volume using the new <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderDomain/init(displayName:userInfo:volumeURL:)> initializer. Store data about the current sync state using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderManager/stateDirectoryURL()>, and determine whether to connect to a domain created on another device using <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderExternalVolumeHandling/shouldConnectExternalDomain(completionHandler:)>.
- Install the File Provider logging profile to log helpful information for debugging and troubleshooting. Download the `.mobileconfig` file at [Profiles and Logs](https://developer.apple.com/bug-reporting/profiles-and-logs/).

## March 2024

- Improve error handling with new underlying error codes for <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderError/Code/providerNotFound>. <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderError/Code/providerDomainTemporarilyUnavailable> indicates that the system is unable to service requests for this domain temporarily, and you can try again later. <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderError/Code/providerDomainNotFound> indicates that there isn’t a registered domain for the corresponding identifier. <doc://com.apple.documentation/documentation/FileProvider/NSFileProviderError/Code/applicationExtensionNotFound> indicates that there isn’t an app extension within the app bundle.

---

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)