---
title: "documentBrowser(_:didRequestDocumentCreationWithHandler:)"
framework: uikit
role: symbol
role_heading: Instance Method
path: "uikit/uidocumentbrowserviewcontrollerdelegate/documentbrowser(_:didrequestdocumentcreationwithhandler:)"
---

# documentBrowser(_:didRequestDocumentCreationWithHandler:)

Asks the delegate to create a new document.

## Declaration

```swift
optional func documentBrowser(_ controller: UIDocumentBrowserViewController, didRequestDocumentCreationWithHandler importHandler: @escaping (URL?, UIDocumentBrowserViewController.ImportMode) -> Void)
```

## Parameters

- `controller`: The current document browser.
- `importHandler`: A block that takes the following parameters:

## Mentioned in

Customizing the document browser Customizing a document-based app’s launch experience

## Discussion

Discussion Implement this method to create new documents for the user: (Optional) Display any controls the user needs to configure the document. Create a new document and save it to a temporary location. If you use a UIDocument subclass to create the document, you must close it before calling the importHandler block. Always open a new document in your documentBrowser(_:didImportDocumentAt:toDestinationURL:) method. Call the provided importHandler block. To confirm the request, pass in the document’s temporary URL and the import mode (UIDocumentBrowserViewController.ImportMode.copy or UIDocumentBrowserViewController.ImportMode.move). To cancel the request, pass nil and UIDocumentBrowserViewController.ImportMode.none. Implement the documentBrowser(_:didImportDocumentAt:toDestinationURL:) method. In this method, open the document at the destination URL. You must use either a UIDocument subclass, or a file presenter and file coordination. Modally present this document to the user. important: You must always call the import handler. If you cannot create a new document, pass nil for the URL and UIDocumentBrowserViewController.ImportMode.none for the import mode. The following example shows a possible implementation of the  documentBrowser(_:didRequestDocumentCreationWithHandler:) method. // Create New Document func documentBrowser(_ controller: UIDocumentBrowserViewController, didRequestDocumentCreationWithHandler importHandler: @escaping (URL?, UIDocumentBrowserViewController.ImportMode) -> Void) {              let doc = // Create a new UIDocument...      let url = // Get a temporary URL...          // Create a new document in a temporary location     doc.save(to: url, for: .forCreating) { (saveSuccess) in                  // Make sure the document saved successfully         guard saveSuccess else {                         // Cancel document creation             importHandler(nil, .none)             return         }                  // Close the document.         doc.close(completionHandler: { (closeSuccess) in                          // Make sure the document closed successfully             guard closeSuccess else {                                 // Cancel document creation                 importHandler(nil, .none)                 return             }                          // Pass the document's temporary URL to the import handler.             importHandler(url, .move)         })     } } After the importHandler block is called, the document browser asynchronously imports the document into its final destination. When possible, the document browser imports to the currently open directory. When there is no currently open directory (for example, when the Recents tab is open), it uses the default directory. Users can set the default directory in Settings. For more information, see Setting up a document browser app. When the import is complete, the browser calls one of the following delegate methods: On success. documentBrowser(_:didImportDocumentAt:toDestinationURL:) On failure. documentBrowser(_:failedToImportDocumentAt:error:) The document browser enables the Add button (+) only when both of the following are true: The allowsDocumentCreation property is set to true (the default value). The document browser delegate implements the documentBrowser(_:didRequestDocumentCreationWithHandler:) method. note: The document browser cannot create new documents if you do not implement this delegate method.

## See Also

### Creating new documents

- [UIDocumentBrowserViewController.ImportMode](uikit/uidocumentbrowserviewcontroller/importmode.md)
- [documentBrowser(_:didImportDocumentAt:toDestinationURL:)](uikit/uidocumentbrowserviewcontrollerdelegate/documentbrowser(_:didimportdocumentat:todestinationurl:).md)
- [documentBrowser(_:failedToImportDocumentAt:error:)](uikit/uidocumentbrowserviewcontrollerdelegate/documentbrowser(_:failedtoimportdocumentat:error:).md)