Invokable Error Dialogs

Updated: Apr 17, 2026

Invokable Error Dialogs allow you to display predefined error messages to your users during multiplayer sessions. Meta Quest provides a set of standardized error dialogs that cover common multiplayer failure scenarios such as full groups, unavailable destinations, and required updates.

Note: This API is part of the MetaXRPlatform plugin, which is separate from the Meta XR Plugin (OculusXR). Ensure the MetaXRPlatform plugin is enabled in your project.

API

Use the GroupPresence_LaunchMultiplayerErrorDialog function to display an error dialog. This function is a latent (asynchronous) node on UOvrRequestsBlueprintLibrary in the **OvrPlatform

GroupPresence** category.

Parameters

The function accepts an FOvrMultiplayerErrorOptions struct with the following field:

ErrorKey: An EOvrMultiplayerErrorErrorKey enum value that determines which error message to display. See Error messages for the full list of available keys.

The function returns:

EOvrRequestOutputPins: Indicates whether the request succeeded or failed.

FString ErrorMsg: Contains an error description if the request fails.

The function returns successfully when the user dismisses the dialog. If the request fails, ErrorMsg contains a description of the failure.

C++ usage

#include "OVRPlatformCppRequests.h"
#include "OVRPlatformOptions.h"

// Create options and set the error key
FOvrMultiplayerErrorOptions Options;
Options.ErrorKey = EOvrMultiplayerErrorErrorKey::General;

// Launch the error dialog
OvrPlatform_GroupPresence_LaunchMultiplayerErrorDialog(
    GetGameInstance(),
    Options,
    OvrPlatform_GroupPresence_LaunchMultiplayerErrorDialog_Delegate::CreateLambda(
        [](bool bSuccess, FString ErrorMsg)
        {
            if (bSuccess)
            {
                // Dialog launched successfully
            }
            else
            {
                UE_LOG(LogTemp, Error, TEXT("Failed to launch error dialog: %s"), *ErrorMsg);
            }
        }));

Blueprint usage

To use this function in Blueprints, search for GroupPresence Launch Multiplayer Error Dialog in the Blueprint action menu, or navigate to the OvrPlatform > GroupPresence category in the Blueprint library.

Error messages

Specify the error using the EOvrMultiplayerErrorErrorKey enum. Each key displays a predefined heading and message to the user:

Key	Heading	Message
DestinationUnavailable	Couldn’t Join	The location you’re trying to join is currently unavailable.
DlcRequired	Couldn’t Join	You don’t have the add-on content required to join the group.
General	Something Went Wrong	Something went wrong. Please try again.
GroupFull	Couldn’t Join	The group you’re trying to join is full.
InviterNotJoinable	Couldn’t Send invite	Something went wrong. Try sending the invite again.
LevelNotHighEnough	Couldn’t Join	You haven’t reached the level required to join the group.
LevelNotUnlocked	Couldn’t Join	You haven’t unlocked the level required to join the group.
NetworkTimeout	Couldn’t Join	Something went wrong. Try joining the group again.
NoLongerAvailable	Couldn’t Join	The group you’re trying to join is no longer available.
UpdateRequired	Update App to Join	An app update is required to join the group. Restart the app to install the update.
TutorialRequired	Couldn’t Join	You haven’t completed the tutorial required to join the group.