Upgrade to AR Foundation version 5
Stay organized with collections
Save and categorize content based on your preferences.
ARCore Extensions for Unity's AR Foundation supports both
version 4
and
version 5
of AR Foundation. To upgrade your existing AR project to AR Foundation 5.x from
AR Foundation 4.x, follow these steps:
Only in Unity 2021.x or older:
Some Unity packages are bound to specific Unity Editor versions.
You may need to edit the Package manifest
in your Unity project to update to AR Foundation 5.x in certain Unity Editor
versions. For more information, see Access AR Foundation 5.0 in Unity
2021.
Ensure that the Packages/manifest.json contains these versions for the
following packages:
"dependencies": {
-- other dependencies --
"com.google.ar.core.arfoundation.extensions": "https://github.com/google-ar/arcore-unity-extensions.git#arf5",
"com.unity.xr.arcore": "5.0.5",
"com.unity.xr.arfoundation": "5.0.5",
"com.unity.xr.arkit": "5.0.5",
-- other dependencies --
}
AR Foundation 5.x requires the Input System package
due to a dependency on TrackedPoseDriver.
The ARCore Extensions Sample Scenes require the legacy input module.
To support both the Input System package and the older Input Manager,
in Project Settings > Player > Other Settings set Active Input
Handling to Both.
Follow other steps in Unity's AR Foundation
upgrade and migration guides.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-14 UTC.
[null,null,["Last updated 2025-07-14 UTC."],[[["\u003cp\u003eARCore Extensions for Unity's AR Foundation supports both AR Foundation version 4 and 5.\u003c/p\u003e\n"],["\u003cp\u003eTo upgrade to AR Foundation 5.x, Unity 2021 or older users may need to update their package manifest to ensure compatibility.\u003c/p\u003e\n"],["\u003cp\u003eAR Foundation 5.x requires the Input System package but maintains backward compatibility with the legacy input module by setting "Active Input Handling" to "Both".\u003c/p\u003e\n"],["\u003cp\u003eConsult Unity's AR Foundation upgrade and migration guides for comprehensive instructions beyond package updates and input settings.\u003c/p\u003e\n"]]],[],null,["# Upgrade to AR Foundation version 5\n\nARCore Extensions for Unity's AR Foundation supports both\n[version 4](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@4.2/manual/index.html)\nand\n[version 5](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.1/manual/index.html)\nof AR Foundation. To upgrade your existing AR project to AR Foundation 5.x from\nAR Foundation 4.x, follow these steps:\n\n1. Only in **Unity 2021.x** or older: \n\n Some Unity packages are [bound to specific Unity Editor versions](https://docs.unity3d.com/Manual/pack-safe.html).\n You may need to edit the [Package manifest](https://docs.unity3d.com/Manual/upm-manifestPkg.html)\n in your Unity project to update to AR Foundation 5.x in certain Unity Editor\n versions. For more information, see [Access AR Foundation 5.0 in Unity\n 2021](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.0/manual/project-setup/edit-your-project-manifest.html).\n\n Ensure that the **Packages/manifest.json** contains these versions for the\n following packages: \n\n \"dependencies\": {\n -- other dependencies --\n \"com.google.ar.core.arfoundation.extensions\": \"https://github.com/google-ar/arcore-unity-extensions.git#arf5\",\n \"com.unity.xr.arcore\": \"5.0.5\",\n \"com.unity.xr.arfoundation\": \"5.0.5\",\n \"com.unity.xr.arkit\": \"5.0.5\",\n -- other dependencies --\n }\n\n2. AR Foundation 5.x requires the [Input System package](https://docs.unity3d.com/Packages/com.unity.inputsystem@1.8/manual/index.html)\n due to a dependency on [`TrackedPoseDriver`](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.0/changelog/CHANGELOG.html#500-pre6---2021-11-17).\n The ARCore Extensions Sample Scenes require the legacy input module.\n\n To support both the Input System package and the older Input Manager,\n in **Project Settings \\\u003e Player \\\u003e Other Settings** set **Active Input\n Handling** to **Both**.\n3. Follow other steps in Unity's AR Foundation\n [upgrade and migration guides](https://docs.unity3d.com/Packages/com.unity.xr.arfoundation@5.1/manual/version-history/migration-guide-5-x.html)."]]
