Develop
Develop
Select your platform

System Deep Linking

Updated: Oct 9, 2024
System deep links allow your app to directly launch built-in apps that are part of the Meta Horizon operating system.
For instance, you can have users press a button in your app to open the store page for your new app, or open a web browser at a given URL.
Intent specifies which built-in app to launch. Additionally, URI is an optional field, accepted by some built-in apps, which launches them in specific states.
ActionIntentURI
Open Browser
systemux://browser
[any valid URL]
Open Store
systemux://store
[none]: Store front page
/item/[ID]: Store page for a given app/IAP
Open Settings
systemux://settings
[none]: Settings main page
/hands: Settings page for hand tracking
/applications?package=com.X.Y: Settings page for an installed app whose Android package is com.X.Y
Open Files app
systemux://file-manager
[none]: ‘Recents’ tab
/media/: ‘Media’ tab
/downloads/: ‘Downloads’ tab
Open Meta bug reporter
systemux://bug_report
N/A
All system deep links are implemented as Android ActivityManager commands. This built-in Android system allows developers to test system deep links interactively, by using adb, with the following command:
adb shell am start -a android.intent.action.VIEW -n com.oculus.vrshell/.MainActivity -d "[INTENT]" -e "uri" "[URI]"
To perform a system deep link, your app should call the following code in a Java plugin built alongside your app:
Context context = UnityPlayer.currentActivity;
PackageManager pm = context.getPackageManager();
Intent intent = pm.getLaunchIntentForPackage("com.oculus.vrshell");
intent.putExtra("intent_data", "[INTENT]");
intent.putExtra("uri", "[URI]");
context.startActivity(intent);
You can also implement the same behavior using Unity’s UnityEngine.AndroidJNIModule to call Java functions from Unity C# code:
AndroidJavaClass unityPlayer = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
AndroidJavaObject currentActivity = unityPlayer.GetStatic<AndroidJavaObject>("currentActivity");
AndroidJavaObject packageManager = currentActivity.Call<AndroidJavaObject>("getPackageManager");
AndroidJavaObject intent = packageManager.Call<AndroidJavaObject>("getLaunchIntentForPackage", "com.oculus.vrshell");
intent.Call<AndroidJavaObject>("putExtra", "intent_data", [INTENT]);
intent.Call<AndroidJavaObject>("putExtra", "uri", [URI]);
currentActivity.Call("startActivity", intent);
Did you find this page helpful?
Thumbs up icon
Thumbs down icon
Nav Logo
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
Virtual reality / Meta Horizon
English (US)
© 2025 Meta