All Oculus Quest developers MUST PASS the concept review prior to gaining publishing access to the Quest Store and additional resources. Submit a concept document for review as early in your Quest application development cycle as possible. For additional information and context, please see Submitting Your App to the Oculus Quest Store.
You can reward your users with custom items when they acquire entitlements (app purchases) or in-game achievements. Custom items are 3D objects that display in the user’s Oculus Home and can help provide additional engagement and awareness for your apps and games.
The first step to offering a successful custom item is to design something that renders correctly in Oculus Home, adheres to Oculus content guidelines, and is popular with your users. For tips to create an item that displays correctly, see Custom Item Design Tips. The next section provides detailed specifications for your custom item.
Oculus Home supports glTF 2.0 binary files, you can find the full specification here. A file must have no validation errors for it to be supported in Oculus Home.
File Type and Size
Textures Make sure your item textures adhere to the following:
Animations Use the following guidelines when adding animations. Note that the first animation will begin looping when the object is loaded in Oculus Home. The following animation types are supported:
Rendering Oculus home supports the rendering for the following:
Model Positioning We respect the glTF 2.0 specification for Coordinate System and Units. In addition:
To make a custom item available to users you will upload it to the developer dashboard, get it approved, and then associate it with an achievement or entitlement.
Before you upload an item to the developer dashboard make sure:
Items and all of their descriptive content should adhere to the Oculus Content Guidelines. You will upload your item to the developer dashboard to start the review process.
To upload an item for review:
Note: Make sure you can access the item in your Oculus Home experience before you submit for review
You must associate a custom item with an achievement or entitlement to make it available to your users.
To associate a custom item with an achievement:
If you haven’t already, create an achievement following the guidance in the information in the Achievements topic.
To associate a custom item with an entitlement:
The system associates a valid app purchase with an entitlement, so you do not need to explicitly create or manage them. An app entitlement has the same name as the purchased app.
Note: After you associate the custom item and save, the item is distributed to all users who have previously unlocked that achievement or entitlement, and in future to any users who unlock the achievement or entitlement.