<!--
{
  "documentType" : "article",
  "framework" : "Virtualization",
  "identifier" : "/documentation/Virtualization/adding-the-virtualization-entitlement-to-your-project",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Adding the Virtualization Entitlement to Your Project"
}
-->

# Adding the Virtualization Entitlement to Your Project

Configure your project to use the Virtualization framework.

## Discussion

To use the Virtualization APIs, a process must have the <doc://com.apple.documentation/documentation/BundleResources/Entitlements/com.apple.security.virtualization> entitlement.

Do the following to add this entitlement to your app:

1. In your project’s “Signing & Capabilities” panel, turn on the App Sandbox. This creates a new entitlement file in your project with the same name as the app target.
2. Select the entitlements file.
3. Click the Add button (+) to add a new property to the entitlements file.
4. Select “Virtualization” from the new property’s type popup menu.
5. Set its value to `YES`.
6. Unless your app requires it in support of another capability, you can remove the app sandbox entitlement key that Xcode creates by default by selecting it and clicking the Remove button (-).

The entitlements file resembles the example settings shown below:

![A screenshot that shows an entitlements file with the settings that allow the use of Virtualization framework.](images/com.apple.virtualization/media-4056508@2x.png)

---

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)