<!--
{
  "availability" : [
    "macOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "FileProvider",
  "identifier" : "/documentation/FileProvider/NSFileProviderManager/disconnect(reason:options:completionHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "File Provider",
      "FileProvider"
    ],
    "preciseIdentifier" : "c:objc(cs)NSFileProviderManager(im)disconnectWithReason:options:completionHandler:"
  },
  "title" : "disconnect(reason:options:completionHandler:)"
}
-->

# disconnect(reason:options:completionHandler:)

Disconnects the domain from the extension.

```
func disconnect(reason localizedReason: String, options: NSFileProviderManager.DisconnectionOptions = [], completionHandler: @escaping @Sendable ((any Error)?) -> Void)
```

## Parameters

`localizedReason`

A localized string that describes the reason for disconnecting the domain.

`options`

Options for the disconnection. For a complete list of valid options, see [`NSFileProviderManager.DisconnectionOptions`](/documentation/FileProvider/NSFileProviderManager/DisconnectionOptions).

`completionHandler`

A block that the system calls after disconnecting the domain. The block takes the following parameter:

- `error`: If an error occurs, this object contains information about the error; otherwise, it’s `nil`.

## Discussion

> Important:
> You can call this method from synchronous code using a completion handler, as shown on this page, or you can call it as an asynchronous method that has the following declaration:
> 
> ```swift
> func disconnect(reason localizedReason: String, options: NSFileProviderManager.DisconnectionOptions = []) async throws
> ```
> 
> For information about concurrency and asynchronous code in Swift, see <doc://com.apple.documentation/documentation/Swift/calling-objective-c-apis-asynchronously>.

Call this method to disconnect the domain from the extension. While the domain is disconnected, the user can continue to browse its content, but the extension no longer receives updates about changes.

Call the [`reconnect(completionHandler:)`](/documentation/FileProvider/NSFileProviderManager/reconnect(completionHandler:)) method to reconnect the domain.

---

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)