---
title: remove()
framework: foundation
role: symbol
role_heading: Instance Method
path: foundation/nsfileversion/remove()
---

# remove()

Remove this version object and its associated file from the version store.

## Declaration

```swift
func remove() throws
```

## Discussion

Discussion This method removes this version object and its file from the version store, freeing up the associated storage space. You must not call this method for the current file version—that is, the version object returned by the currentVersionOfItem(at:) method. You should always remove file versions as part of a coordinated write operation to a file. In other words, always call this method from a block passed to a file coordinator object to initiate a write operation. Doing so ensures that no other processes are operating on the file while you remove the version information. If successful, subsequent requests for the versions of the file do not include this version object (or any object with the same information). You can use this method to free up disk space by removing versions that are no longer needed. note: In Swift, this method returns Void and is marked with the throws keyword to indicate that it throws an error in cases of failure. You call this method in a try expression and handle any errors in the catch clauses of a do statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters.

## See Also

### Replacing and Deleting Versions

- [replaceItem(at:options:)](foundation/nsfileversion/replaceitem(at:options:).md)
- [removeOtherVersionsOfItem(at:)](foundation/nsfileversion/removeotherversionsofitem(at:).md)