---
title: filename
framework: foundation
role: symbol
role_heading: Instance Property
path: foundation/filewrapper/filename
---

# filename

The filename of the file wrapper object

## Declaration

```swift
var filename: String? { get set }
```

## Discussion

Discussion This property contains the file wrapper’s filename, or nil when the file wrapper has no corresponding file-system node. The filename is used for record-keeping purposes only and is set automatically when the file wrapper is created from the file system using init(url:options:) and when it’s saved to the file system using write(to:options:originalContentsURL:) (although this method allows you to request that the filename not be updated). The filename is usually the same as the preferred filename, but might instead be a name derived from the preferred filename.  You can use this method to get the name of a child that’s just been read. Don’t use this method to get the name of a child that’s about to be written, because the name might be about to change; send keyForChildFileWrapper(_:) to the parent instead.

## See Also

### Accessing Files

- [preferredFilename](foundation/filewrapper/preferredfilename.md)
- [fileAttributes](foundation/filewrapper/fileattributes.md)
- [regularFileContents](foundation/filewrapper/regularfilecontents.md)