---
title: "move(completionHandler:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsdocument/move(completionhandler:)"
---

# move(completionHandler:)

Moves the document to a user-selected location.

## Declaration

```swift
func move(completionHandler: ((Bool) -> Void)? = nil)
```

```swift
func move() async -> Bool
```

## Parameters

- `completionHandler`: The completion handler block object passed in to be invoked after moving is completed, regardless of success, failure, or cancellation of moving action.

## Discussion

Discussion This method presents the user with a move panel if [self fileURL] is non-nil and then tries to save the document to the new location by invoking the move(to:completionHandler:) method if the user accepts the location presented by the panel. If a file with the same name already exists at that location, the user will be asked to choose between replacing the pre-existing file, renaming the current document, or canceling the move process. If [self fileURL] is nil, then the [self runModalSavePanelForSaveOperation:NSSaveAsOperation delegate:didSaveSelector:contextInfo:] message is sent instead.

## See Also

### Related Documentation

- [moveToUbiquityContainer(_:)](appkit/nsdocument/movetoubiquitycontainer(_:).md)

### Moving the Document

- [move(_:)](appkit/nsdocument/move(_:).md)
- [move(to:completionHandler:)](appkit/nsdocument/move(to:completionhandler:).md)