Meta Developers

Apps that target Meta Quest have a stringent set of packaging requirements and any app you upload must be packaged accordingly. The upload validator rejects apps that do not meet these requirements.

Additionally, your apps are checked for the following items:

Proper controller support. Controllers are different depending on the device type. If your app displays a visible controller, you should change the model displayed depending on what device you are running on. Alternatively, a stylized controller model that is distinct from the Meta Quest Touch controllers is acceptable.
A correct application manifest. The application manifest of your app must conform to our specifications if you want to upload the app to the Meta Horizon Store. For more information, see Application Manifests for Release Builds.
A correctly signed APK. Different devices require different signing schemes. For more information, see Application Signing.

Prerequisites

Before you can upload your app, you must:

Have a Meta account and set up a development organization. For more information, see Manage Your Organization and Users
Create a page for your app in the Meta Quest Developer Dashboard. For more information, see Creating Your App Page.
Make sure your app and expansion files meet the size requirements. The APK may be up to 1 GB in size. The expansion file (if one is being used) may be up to 4 GB in size.
The APK must have an application manifest that is fit for a release build. See Application Manifests for Release Builds.
The APK must be signed with an Android certificate. For more information, see Application Signing.

Uploading your build

You can upload 2D and immersive app builds with:

Additionally, you can upload apps made in Unity or Unreal through the editors:

For information on Unity, see Upload Apps from the Unity Editor.
For Unreal Engine, see Upload Apps from the Unreal Editor

Uploading your app through the command line interface

The Oculus Platform Command Line Utility uses delta-patching techniques to upload only the portions of your app that have changed, so generally this is faster. Additionally, the command line utility can handle larger app packages. If there are any packaging problems with your app, the upload validation routines inform you after uploading your build so that you can correct the issue and try again.

For more information on using this utility, see the Oculus Platform Command Line Utility.

Uploading your app through the Meta Quest Developer Hub

The Meta Quest Developer Hub provides a graphical wrapper around the command line interface. Use the following steps to upload your app to the Developer Dashboard through the Meta Quest Developer Hub.

Note

If you previously submitted a build with expansion files, you must use the Oculus Platform Command Line Utility to upload the new binary along with the expansion files, and cannot upload the new build using the developer dashboard.

To upload a build

Verify that your build meets the release packaging requirements for your platform. 2D and immersive applications have different required VRCs. Make sure to understand what is required for your app type. For more information, see the Virtual Reality Check (VRC) Guidelines.
Open Meta Quest Developer Hub, ensure it is logged in with the account associated with the app you want to upload to.
Click on App Distribution on the left-side navigation bar, select the correct Org and App.
Click Upload action button on the Release Channels you are targeting.
Follow instructions to select and upload your build files, make sure to write proper Release Notes.
Click Upload.

Uploading your app from the Unity or Unreal editors

If you are using the Oculus Integration SDK with Unity or Unreal engine, you can upload your build through the editor. Your app packages should be less than 1 GB in size.

For Unity, see Upload Apps from the Unity Editor.
For Unreal, see Upload Apps from the Unreal Editor.

Changing to a previous build

If users experience a problem with a build, you can use the Select Build functionality to change to a previous app build, or upload a new build.

Did you find this page helpful?