<!--
{
  "availability" : [
    "iOS: 27.2.0 -",
    "iPadOS: 27.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "BundleResources",
  "identifier" : "/documentation/BundleResources/Information-Property-List/NSUserTrackingMarkdownUsageDescription",
  "metadataVersion" : "0.1.0",
  "role" : "Property List Key",
  "symbol" : {
    "kind" : "Property List Key",
    "modules" : [
      "Bundle Resources"
    ],
    "preciseIdentifier" : "plist:Information_Property_List.NSUserTrackingMarkdownUsageDescription"
  },
  "title" : "NSUserTrackingMarkdownUsageDescription"
}
-->

# NSUserTrackingMarkdownUsageDescription

A message that explains the purpose for accessing data that an application can use to track a person or device.

## Discussion

If your application uses the <doc://com.apple.documentation/documentation/AppTrackingTransparency> framework, use this key to provide a *usage-description string* to explain your app’s purpose for accessing data that the app can use to track the person or the device. The system displays the string value in a full-page authorization sheet from which the person can grant or deny permission to access the tracking data.

The format of the string is Markdown text; you can apply bold or italic style, but it doesn’t support underline. You can include bullet lists and paragraph breaks.

This key is optional. The system uses the [`NSUserTrackingUsageDescription`](/documentation/BundleResources/Information-Property-List/NSUserTrackingUsageDescription) if your app’s target properties omit this key.

This key has regional availability. To use this key, the system requires that the device be located in a specific European Union (EU) country and signed in with an Apple Account that has its country or region set to a specific EU country or region:

- France, Germany, Italy, Poland, and Romania: The system uses this key, if available.
- The European Union: The system uses this key if available when your app calls <doc://com.apple.documentation/documentation/AppTrackingTransparency/ATTrackingManager/requestTrackingAuthorization(usingExpandedInterface:additionalInformationAction:completionHandler:)>, passing `preferExpandedInterface` a value of `true`.

Outside of the EU, the system uses the [`NSUserTrackingUsageDescription`](/documentation/BundleResources/Information-Property-List/NSUserTrackingUsageDescription) key instead of this key.

> Tip: Keep the text of your description short and specific. The system displays your app name in the prompt so you don’t need to include it in the string. For example usage descriptions, see [Apple’s Human Interface Guidelines](https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/accessing-user-data/).

---

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)