Announce new changes or updates in your app, such as a new game mode, level, social feature, or character class. Announcements may be shown in Explore if the post matches a user's interests. Announcements will be shown in the Oculus Explore sections of Home.

Create an Announcement Post

To create an Announcement post, go to your app's Oculus dashboard in the Developer Center and select Discoverability / Announcements.

Note: These posts are only shown to English speaking users at this time.

Enter the following information to create your announcement or story.

  1. Tagline - A 2-5 word sentence about your announcement.
  2. Description - A longer form detail about the announcement. The description should be 2-3 sentences about your story and cannot include HTML or other markup. This should be specific to your announcement content, not a copy of your app's description.
  3. Image - Image for the announcement. This should be different than your cover art. It should reflect your Announcement, be 16:9 Aspect Ratio, and a 2560 x 1440 24-bit .png file.
  4. Facebook Trailer Video URL - After uploading a 2D or 360 video (preferred) to your Facebook Page, copy and paste the video URL and provide it here. Details about creating the trailer can be found in the Create a Trailer Video section below. This video is required to create an announcement.
  5. Start Time - The time you would like your story to start showing up in Oculus Explore.
  6. Deeplink Message (optional) - A string that you create that will be provided as a parameter in the app launch intent. If a user does not have your app installed when clicking on the deep-link, we will prompt them to purchase your app.

Integrate Announcements

Integrating deeplink support for Announcements is optional. If you do not use deeplinks, the app will be launched by the normal launch process.

You'll integrate a hook into your app that listens for a specific launch detail when the app is started, ovrLaunchType_Deeplink on Native Android and Launchtype.Deeplink on Unity. When you see these details in the launch event, your app will retrieve the deeplink that you defined to direct the user to the appropriate location in your app.

For example, on Native Android:

ovrLaunchDetailsHandle handle = ovr_ApplicationLifecycle_GetLaunchDetails();
if (ovr_LaunchDetails_GetLaunchType(handle) == ovrLaunchType_Deeplink) {
 string deeplink = ovr_LaunchDetails_GetDeeplinkMessage(handle);

On Unity:

using Oculus.Platform.Models;
LaunchDetails launchDetails = new LaunchDetails(CAPI.
if (launchDetails.LaunchType == LaunchType.Deeplink) {
 String deeplinkMessage = launchDetails.DeeplinkMessage;

If you're using Unreal, please use the native API using the information found in Unreal Development Getting Started.

Create a Trailer Video

A 2D video trailer is required to create an Announcement.

You can publish a 2D video to FB as a 'Secret' video and use that for your story if you don't want to share the video outside the Oculus environment.

  1. Go to Publishing Tools / Video Library. Information about this process can be found in the Facebook Publishing FAQ.
  2. Select the video.
  3. In the Video Details dialog box, click Create Post With Video.
  4. Select the Advanced tab.
  5. Change Distribution to Custom.
  6. Select Add as secret video.

Then, once you've created the video, retrieve the URL.

  1. Go to Publishing Tools / Video Library.
  2. Select the video.
  3. In the Video Details dialog box, select the post you just created (at the bottom).
  4. Click View Permalink.

Content Review

All posts and stories will reviewed by the Oculus team for content approval and compliance with the Oculus Code of Conduct. If the submission does not comply, it will be rejected.

Preview Your Announcement

Want to see how your announcement will look before releasing to the public? To test-

  1. Create an announcement and save it as a draft.
  2. Launch your mobile VR device. At the bottom of Home, select the gear icon to open the settings menu. In the settings menu select Developer Settings, and then choose View Developer Feed. You'll need to be a Developer or Admin in your organization to see this menu.
  3. Select the Home tab, and preview your announcement in Explore.
  4. (Optional) If you've chosen to integrate deeplinks, you may select the announcement link to launch your app and test the deeplink.
  5. When you're satisfied with the announcement and deeplink, you can submit the announcement for review and public release.