# Using the file system effectively Gain access to benefits like automatic backup or purging by using purpose-built directories provided by the system. ## Discussion When apps persist data, they often use different files for different purposes. For example, when someone uses your app to create a document, the app stores the document permanently, and makes it available for automated backup. Your app may also create files it requires to function, but that won’t be visible while someone’s using the app. Still other types of files may be useful for a time, but eventually eligible for deletion. Foundation provides special directories for different kinds of files, some of which offer unique behaviors that can help your app to store files more efficiently. By thoughtfully managing your use of file system resources, you can avoid wasting space, which provides the following advantages: - Your app won’t prevent the system from performing an update due to lack of space. - Your app becomes less likely to be deleted and redownloaded during a system update. - The person using your app may be less likely to delete your app to free up storage space. - Your app benefits from smaller, faster backups. In addition, using the right directories for the right files provides useful features, like automatic backup or purging. > Tip: If the data you need to persist is very small – several strings or name-value pairs – you might find it more convenient to use ``doc://com.apple.foundation/documentation/Foundation/UserDefaults`` instead of managing flat files. ### Access common directories On iOS, tvOS, watchOS, and visionOS, apps perform all their file access within the app’s bundle. There’s no access outside of the bundle, except in cases where higher-level APIs access outside files on the app’s behalf, like when you use to play songs from the device’s music library. A sandboxed macOS app uses a similar setup. Within the bundle, the system provides specific directories, some with distinct behaviors, such as backing up, or periodically purging files. Access these directories with methods and properties from the [`URL`](/documentation/Foundation/URL) and [`FileManager`](/documentation/Foundation/FileManager) types: - In Swift, [`URL`](/documentation/Foundation/URL) defines properties for common directories like [`documentsDirectory`](/documentation/Foundation/URL/documentsDirectory), [`cachesDirectory`](/documentation/Foundation/URL/cachesDirectory), [`temporaryDirectory`](/documentation/Foundation/URL/temporaryDirectory), and so on. Each of these properties is a single, nonoptional [`URL`](/documentation/Foundation/URL) instance that you can use with [`FileManager`](/documentation/Foundation/FileManager). - In Swift or Objective-C, you can use the [`FileManager`](/documentation/Foundation/FileManager) method [`urls(for:in:)`](/documentation/Foundation/FileManager/urls(for:in:)) to access common directories. The `for` parameter takes a [`FileManager.SearchPathDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory), a type that defines constants to search for common directories like [`FileManager.SearchPathDirectory.documentDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/documentDirectory) and [`FileManager.SearchPathDirectory.cachesDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/cachesDirectory). Use these APIs whenever possible. Don’t hard-code paths to what appear to be common directories, since apps like Finder may localize directory names and omit file extensions when presenting them in the user interface. ### Store long-lived files When writing a document-based app with APIs like and , store files in the `Documents` folder. You can access this folder with the URL [`documentsDirectory`](/documentation/Foundation/URL/documentsDirectory) or the search path [`FileManager.SearchPathDirectory.documentDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/documentDirectory). You can also use this folder for other files managed by the person using your app, even if you don’t use the or APIs. The system backs up files in the `Documents` folder when connecting an iOS device to a macOS computer with a USB cable, or when performing an iCloud backup. The system can also make the contents of the `Documents` folder available for file sharing. Only store files in this folder that you want to expose to the person using your app. Additionally, when you store files in the `Documents` folder in an iOS app, they also become visible in the system “Files” app. For support files that your app needs to operate but that you don’t want to be openly visible, prefer the `ApplicationSupport` directory by using the URL property [`applicationSupportDirectory`](/documentation/Foundation/URL/applicationSupportDirectory) or the search path [`FileManager.SearchPathDirectory.applicationSupportDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/applicationSupportDirectory). This directory stores data like configuration files, templates, and modified versions of default files from your bundle. The system also includes the contents of this folder as part of regular backups. > Important: If you want to exclude an item in `Documents` or `ApplicationSupport` from backup, call ``doc://com.apple.foundation/documentation/Foundation/URL/setResourceValues(_:)`` with the value ``doc://com.apple.foundation/documentation/Foundation/URLResourceValues/isExcludedFromBackup`` in Swift, or ``doc://com.apple.foundation/documentation/Foundation/NSURL/setResourceValue(_:forKey:)`` with the key ``doc://com.apple.foundation/documentation/Foundation/URLResourceKey/isExcludedFromBackupKey`` in Objective-C. Exclude from the backup any file that your app can recreate or redownload, particularly large media files. ### Store short-lived files Your app may also use shorter-lived files that you don’t need backed up or stored permanently. Foundation provides several directories for storing these kinds of files. Access the temporary directory with the URL property [`temporaryDirectory`](/documentation/Foundation/URL/temporaryDirectory), and the file manager property [`temporaryDirectory`](/documentation/Foundation/FileManager/temporaryDirectory). Use this directory for files with a short lifespan, like the side effects of computational operations, or one-time downloads that can be discarded after use. Only use the temporary directory for files that you don’t need to persist between launches of the app, because the system may purge this directory when your app isn’t running. There’s no guarantee of when or if the system will clear the directory, however, so delete temporary files as soon as you know you don’t need them. For files that persist longer than temporary files, but are still purgeable, use the *caches* directory. In the caches directory, store files the app doesn’t require to operate, but that improve performance, such as database cache files and transient, downloadable content. Access the caches directory with the URL property [`cachesDirectory`](/documentation/Foundation/URL/cachesDirectory) or the file manager search path [`FileManager.SearchPathDirectory.cachesDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/cachesDirectory). As with the temporary directory, the system may purge this directory when your app isn’t running. Your app needs to either be able to operate without these files, or regenerate them as needed. Additionally, invalidate and delete cache files when you can, and don’t waste storage on unnecessary files. The system doesn’t back up either the temporary directory or the caches directory. The following decision tree summarizes the factors to consider when choosing a storage directory, and the [`URL`](/documentation/Foundation/URL) constants for those directories.  ### Access the rest of the file system in a non-sandboxed macOS app A non-sandboxed macOS app can access files outside of its own container. This ability can be useful for apps that read from and write to other locations in the file system. > Tip: To use files outside the app container of a sandboxed macOS app, see . When a macOS app isn’t sandboxed, the common directory properties in [`URL`](/documentation/Foundation/URL) provide different values. For example, in a non-sandboxed macOS app, [`applicationSupportDirectory`](/documentation/Foundation/URL/applicationSupportDirectory) is “`~/Library/Application Support`”, and [`cachesDirectory`](/documentation/Foundation/URL/cachesDirectory) is “`~/Library/Caches`”. This difference in values also applies when using [`urls(for:in:)`](/documentation/Foundation/FileManager/urls(for:in:)) with search path constants like [`FileManager.SearchPathDirectory.applicationSupportDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/applicationSupportDirectory) and [`FileManager.SearchPathDirectory.cachesDirectory`](/documentation/Foundation/FileManager/SearchPathDirectory/cachesDirectory). --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)