Skip to main content
Version: Current

Unsafe Unity Instance


It is not recommended to use this API unless you are an advanced user. Please make sure that any changes made to, or events bound to the Unity Instance are not reflected inside of the module. This could lead to unexpected behaviour, use with caution.

In the rare case that you need to access the Unity Instance directly, you can do so by using the useUnityContext hook to return a reference to the Unity Instance.

Type Definition

Type Definition
const UNSAFE__unityInstance: UnityInstance | null = null;

Example Usage

A basic implementation could look something like this. In the following example we'll bind the Unity Instance to the window so external scripts can access it.

import React, { useEffect } from "react";
import { Unity, useUnityContext } from "react-unity-webgl";

function App() {
const { unityProvider, UNSAFE__unityInstance } = useUnityContext({
loaderUrl: "build/myunityapp.loader.js",
dataUrl: "build/",
frameworkUrl: "build/myunityapp.framework.js",
codeUrl: "build/myunityapp.wasm",

() => (window.unityInstance = UNSAFE__unityInstance),

return <Unity unityProvider={unityProvider} />;