# Handling Errors with User-Driven Actions Handle any errors that occur while processing the action. ## Discussion Whenever possible, handle the error in a way that allows the local action to succeed. If the local action can succeed, pass `nil` to the completion handler’s `error` property, and then fix any inconsistencies after the fact. However, if an unrecoverable error occurs, do not make the local change. Instead, create an error object that describes the problem and pass it to the completion handler. In general, this error is presented to the user, and the action is canceled. The following sections describe tactics for responding to specific error types. ### Responding to Upload Errors Handle any errors that occur while uploading the changes to your server (such as [`NSFileProviderError.Code.insufficientQuota`](/documentation/FileProvider/NSFileProviderError/Code/insufficientQuota) errors) by updating the item locally and setting its [`uploadingError`](/documentation/FileProvider/NSFileProviderItemProtocol/uploadingError) property. Upload errors should not prevent local changes. Instead, attempt to sync the change again, after the error is resolved. For authentication errors, you can present a custom user interface using the framework. For more information, see the class’s method. ### Responding to Name Collisions If a name collision occurs when syncing a local item with your server, update the local item, giving it a unique file name. A name collision is not considered an error. If, however, you can detect a name collision locally, call the method to create a [`NSFileProviderError.Code.filenameCollision`](/documentation/FileProvider/NSFileProviderError/Code/filenameCollision) error, and pass this error to the completion handler. The system then asks the user if they want to replace the existing item (taking into account its [`allowsTrashing`](/documentation/FileProvider/NSFileProviderItemCapabilities/allowsTrashing) and [`allowsDeleting`](/documentation/FileProvider/NSFileProviderItemCapabilities/allowsDeleting) capabilities). Perform all collision checks using case-insensitive comparisons, even if the filesystem or file provider allows case-sensitive names. --- Copyright © 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)