# Loadable<T>

> Serialized reference that loads a specific T asset from registered built content on demand instead of pulling it in with direct references.

## Definition

* **Type:** Class
* **Namespace:** [Unity.Loading](/engine/6000.6/script-reference/unity/loading.md)
* **Assembly:** UnityEngine.ContentLoadModule

```csharp
public sealed class Loadable<T> where T : Object
```

## Remarks

Add a [Loadable\<T>](/engine/6000.6/script-reference/unity/loading/loadable1.md) field to a [ScriptableObject](/engine/6000.6/script-reference/unityengine/scriptableobject.md) or [MonoBehaviour](/engine/6000.6/script-reference/unityengine/monobehaviour.md) to reference an asset without loading it immediately. The reference is stored as a [Loadable\<T>.LoadableObjectId](/engine/6000.6/script-reference/unity/loading/loadable1/loadableobjectid.md), which you create in the Editor with [LoadableObjectIdEditorUtility](/engine/6000.6/script-reference/unityeditor/loadableobjectideditorutility.md). When the containing object is built into a content directory with [BuildPipeline.BuildContentDirectory](/engine/6000.6/script-reference/unityeditor/buildpipeline/buildcontentdirectory.md), the referenced asset and its dependencies are pulled into the build output.

At runtime, call [Loadable\<T>.Load](/engine/6000.6/script-reference/unity/loading/loadable1/load.md) or [Loadable\<T>.LoadAsync](/engine/6000.6/script-reference/unity/loading/loadable1/loadasync.md) to load the asset on demand, read it from [Loadable\<T>.Target](/engine/6000.6/script-reference/unity/loading/loadable1/target.md), and call [Loadable\<T>.Release](/engine/6000.6/script-reference/unity/loading/loadable1/release.md) when it is no longer needed. The asset must belong to a content directory that has been registered with [ContentLoadManager.RegisterContentDirectory](/engine/6000.6/script-reference/unity/loading/contentloadmanager/registercontentdirectory.md).

In Play mode you can load built content with much the same code and behavior as in the Player. Register the content directory with [ContentLoadManager.RegisterContentDirectory](/engine/6000.6/script-reference/unity/loading/contentloadmanager/registercontentdirectory.md), get its root assets with [ContentLoadManager.GetRootAssets](/engine/6000.6/script-reference/unity/loading/contentloadmanager/getrootassets.md), then read the [Loadable\<T>](/engine/6000.6/script-reference/unity/loading/loadable1.md) fields on those root assets or on any asset or scene they reference. A [Loadable\<T>](/engine/6000.6/script-reference/unity/loading/loadable1.md) reached from built content always loads its asset from that built content, never from the project.

In Play mode you can also load the live project version of an asset, such as a scene loaded by path with [SceneManager.LoadSceneAsync](/engine/6000.6/script-reference/unityengine/scenemanagement/scenemanager/loadsceneasync.md) or a [ScriptableObject](/engine/6000.6/script-reference/unityengine/scriptableobject.md) loaded through [AssetDatabase](/engine/6000.6/script-reference/unityeditor/assetdatabase.md). A [Loadable\<T>](/engine/6000.6/script-reference/unity/loading/loadable1.md) field on an asset loaded this way always resolves to the latest project version of the referenced asset through the [AssetDatabase](/engine/6000.6/script-reference/unityeditor/assetdatabase.md), even when a registered content directory contains a built version of that asset.

Content loaded from the [AssetDatabase](/engine/6000.6/script-reference/unityeditor/assetdatabase.md) in this way is not reference counted, so [Loadable\<T>.Release](/engine/6000.6/script-reference/unity/loading/loadable1/release.md) does not unload it. It unloads through the same garbage collection that handles other AssetDatabase content in the Editor. The asset unloads when nothing references it and a collection runs. Call [Resources.UnloadUnusedAssets](/engine/6000.6/script-reference/unityengine/resources/unloadunusedassets.md) to force a collection.

A [Loadable\<T>](/engine/6000.6/script-reference/unity/loading/loadable1.md) field is only supported in content built with [BuildPipeline.BuildContentDirectory](/engine/6000.6/script-reference/unityeditor/buildpipeline/buildcontentdirectory.md). If a Loadable field is found in serialized data during a Player or AssetBundle build, the underlying reference is set to null in the build output and an error is logged. Suppress this error with [BuildOptions.SuppressLoadableErrors](/engine/6000.6/script-reference/unityeditor/buildoptions/suppressloadableerrors.md) for Player builds or [BuildAssetBundleOptions.SuppressLoadableErrors](/engine/6000.6/script-reference/unityeditor/buildassetbundleoptions/suppressloadableerrors.md) for AssetBundle builds.

Additional Resources: [Loadable\<T>.LoadableObjectId](/engine/6000.6/script-reference/unity/loading/loadable1/loadableobjectid.md), [LoadableObjectIdEditorUtility](/engine/6000.6/script-reference/unityeditor/loadableobjectideditorutility.md), [BuildPipeline.BuildContentDirectory](/engine/6000.6/script-reference/unityeditor/buildpipeline/buildcontentdirectory.md), [ContentLoadManager](/engine/6000.6/script-reference/unity/loading/contentloadmanager.md)

## Examples

```csharp
using System.Threading.Tasks;
using Unity.Loading;
using UnityEngine;

namespace BuildDocExamples
{
    public class Loadable_LoadAndReleaseExample
    {
        public class HatPicker : MonoBehaviour
        {
            public Loadable<GameObject> hatPrefab;

            public void EquipDefault()
            {
                hatPrefab.Load();
                Instantiate(hatPrefab.Target);
            }
        }

        // Example showing async loading with status check
        public async Task LoadAsyncExample(Loadable<Texture2D> myLoadable)
        {
            await myLoadable.LoadAsync();
            if (myLoadable.Status == LoadableStatus.Loaded)
            {
                // Use myLoadable.Target
                Debug.Log($"Loaded: {myLoadable.Target.name}");
            }
            else
            {
                Debug.LogWarning($"Texture2D myLoadable failed to load. Loadable : {myLoadable.ToString()}");
            }
            myLoadable.Release();
        }
    }
}
```

## Constructors

| Constructor                                                                                                     | Description                                                   |
| --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [Loadable\`1(Unity.Loading.LoadableObjectId@)](/engine/6000.6/script-reference/unity/loading/loadable1/ctor.md) | Creates a new Loadable with the specified loadable object id. |

## Properties

| Property                                                                                        | Description                                                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [LoadableObjectId](/engine/6000.6/script-reference/unity/loading/loadable1/loadableobjectid.md) | The underlying loadable object id.                                                                                                                                                                                                              |
| [Status](/engine/6000.6/script-reference/unity/loading/loadable1/status.md)                     | The current status of the loading operation.                                                                                                                                                                                                    |
| [Target](/engine/6000.6/script-reference/unity/loading/loadable1/target.md)                     | The result of the load operation. If the operation is not complete or has failed, this returns null. Use [Loadable\<T>.Load](/engine/6000.6/script-reference/unity/loading/loadable1/load.md) to force the operation to complete synchronously. |

## Methods

| Method                                                                            | Description                                                                                    |
| --------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| [Load](/engine/6000.6/script-reference/unity/loading/loadable1/load.md)           | Loads the object synchronously. Blocks until loading is complete.                              |
| [LoadAsync](/engine/6000.6/script-reference/unity/loading/loadable1/loadasync.md) | Loads the object asynchronously. Returns an awaitable that completes when loading is finished. |
| [Release](/engine/6000.6/script-reference/unity/loading/loadable1/release.md)     | Releases the loaded object so that Unity can unload it.                                        |
| [ToString](/engine/6000.6/script-reference/unity/loading/loadable1/tostring.md)   | Returns a string representation of the loadable object id.                                     |