---
title: Providing support for user-driven actions
framework: fileprovider
role: collectionGroup
path: fileprovider/providing-support-for-user-driven-actions
---

# Providing support for user-driven actions

Override methods to handle user-initiated actions.

## Overview

Overview When the user performs an action in the document browser (for example, moving, renaming, or deleting an item) the system calls the corresponding method on your NSFileProviderExtension subclass. The following table shows the action method for each action type:  |   |   |   |   |   |   |   |   |   |   |  When the action method is called, ensure that your implementation: Makes any necessary local changes, including updates to the working set Schedules a background update for your server Signals that the changes have occurred Calls the completion handler with the results All the action methods are expected to work offline, and should return immediately. Call the completion handler before performing any network activity or other long-running tasks. Defer these tasks to the background.

## Topics

### Signaling Changes

- [Signaling Changes for User-Driven Actions](fileprovider/signaling-changes-for-user-driven-actions.md)

### Handling Errors

- [Handling Errors with User-Driven Actions](fileprovider/handling-errors-with-user-driven-actions.md)

## See Also

### Handling actions

- [createDirectory(withName:inParentItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/createdirectory(withname:inparentitemidentifier:completionhandler:).md)
- [deleteItem(withIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/deleteitem(withidentifier:completionhandler:).md)
- [importDocument(at:toParentItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/importdocument(at:toparentitemidentifier:completionhandler:).md)
- [renameItem(withIdentifier:toName:completionHandler:)](fileprovider/nsfileproviderextension/renameitem(withidentifier:toname:completionhandler:).md)
- [reparentItem(withIdentifier:toParentItemWithIdentifier:newName:completionHandler:)](fileprovider/nsfileproviderextension/reparentitem(withidentifier:toparentitemwithidentifier:newname:completionhandler:).md)
- [setFavoriteRank(_:forItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/setfavoriterank(_:foritemidentifier:completionhandler:).md)
- [setLastUsedDate(_:forItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/setlastuseddate(_:foritemidentifier:completionhandler:).md)
- [setTagData(_:forItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/settagdata(_:foritemidentifier:completionhandler:).md)
- [trashItem(withIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/trashitem(withidentifier:completionhandler:).md)
- [untrashItem(withIdentifier:toParentItemIdentifier:completionHandler:)](fileprovider/nsfileproviderextension/untrashitem(withidentifier:toparentitemidentifier:completionhandler:).md)