<!--
{
  "documentType" : "article",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/privacy-manifest-files",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Privacy manifest files"
}
-->

# Privacy manifest files

Describe the data your app or third-party SDK collects and the required reasons APIs it uses.

## Discussion

Apps and third-party SDKs — distributed as XCFrameworks, Swift packages, or Xcode projects — can contain a privacy manifest file, named `PrivacyInfo.xcprivacy`. The privacy manifest is a property list that records the following information:

- The types of data collected by your app or third-party SDK. You need to provide this information for your app or third-party SDK on all platforms.
- The required reasons APIs your app or third-party SDK uses. You need to provide this information for your app or third-party SDK on iOS, iPadOS, tvOS, visionOS, and watchOS.

For each type of data your app or third-party SDK collects and category of required reasons API it uses, the app or third-party SDK needs to record the reasons in its bundled privacy manifest file.

> Important:
> You need to include a privacy manifest file in your third-party SDK if it’s listed in “SDKs that require a privacy manifest and signature,” in [Upcoming third-party SDK requirements](https://developer.apple.com/support/third-party-SDK-requirements/). Otherwise, include a privacy manifest file in your third-party SDK if it uses a required reasons API, collects data about the person using apps that include the third-party SDK, enables the app to collect data about people using the app, or contacts tracking domains. Providing a privacy manifest file helps app developers understand the API use and data-collection practices of your third-party SDK.

For information on editing the privacy manifest file, see <doc://com.apple.documentation/documentation/Xcode/editing-property-list-files>.

### Create a privacy manifest

To add the privacy manifest to your app or third-party SDK in Xcode, follow these steps:

- Choose File > New File.
- Scroll down to the Resource section, and select App Privacy File type.
- Click Next.
- Check your app or third-party SDK’s target in the Targets list.
- Click Create.

By default, the file is named `PrivacyInfo.xcprivacy`; this is the required file name for bundled privacy manifests.

> Note:
> You need to add the privacy manifest file to your target’s resources for Xcode to use it when you generate a privacy report. If you distribute your third-party SDK as a static library, use the support for static frameworks in Xcode 15 or later to bundle resources, including the privacy manifest file. Create a framework target in Xcode that builds your product, set its Mach-O type build setting to “Static Library,” and add the privacy manifest file to your target’s bundle resources along with any other resources, for example, image files.

At the top level of this property list file, add the following keys to the dictionary:

- [`NSPrivacyTracking`](/documentation/BundleResources/App-Privacy-Configuration/NSPrivacyTracking): A Boolean that indicates whether your app or third-party SDK uses data for tracking as defined under the App Tracking Transparency framework. When set to `true` you need to provide a list of internet domains in `NSPrivacyTrackingDomains`. For more information, see [User Privacy and Data Use](https://developer.apple.com/app-store/user-privacy-and-data-use/).
- [`NSPrivacyTrackingDomains`](/documentation/BundleResources/App-Privacy-Configuration/NSPrivacyTrackingDomains): An array of strings that lists the internet domains your app or third-party SDK connects to that engage in tracking. If the user has not granted tracking permission through the App Tracking Transparency framework, network requests to these domains fail and your app receives an error. To provide a list of internet domains in `NSPrivacyTrackingDomains`, set `NSPrivacyTracking` to `true`.
- [`NSPrivacyCollectedDataTypes`](/documentation/BundleResources/App-Privacy-Configuration/NSPrivacyCollectedDataTypes): An array of dictionaries that describes the data types your app or third-party SDK collects. For information on the keys and values to use in the dictionaries, see [Describing data use in privacy manifests](/documentation/BundleResources/describing-data-use-in-privacy-manifests).
- [`NSPrivacyAccessedAPITypes`](/documentation/BundleResources/App-Privacy-Configuration/NSPrivacyAccessedAPITypes): An array of dictionaries that describe the API types your app or third-party SDK accesses that have been designated as APIs that require reasons to access. For information on the keys and values to use in the dictionaries, see [Describing use of required reason API](/documentation/BundleResources/describing-use-of-required-reason-api).

## Topics

### Essentials

[Adding a privacy manifest to your app or third-party SDK](/documentation/BundleResources/adding-a-privacy-manifest-to-your-app-or-third-party-sdk)

Report the data you collect and the required reasons API you use in your app or third-party SDK.

[Describing data use in privacy manifests](/documentation/BundleResources/describing-data-use-in-privacy-manifests)

Declare the data collected by your app or by third-party SDKs.

[Describing use of required reason API](/documentation/BundleResources/describing-use-of-required-reason-api)

Ensure your use of covered API is consistent with policy.

  <doc://com.apple.documentation/documentation/Xcode/editing-property-list-files>

[`App Privacy Configuration`](/documentation/BundleResources/App-Privacy-Configuration)

A data structure that represents the root object in a privacy manifest file.



---

Copyright &copy; 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)