---
title: ContentDirectoryLoadInfo
product: Unity Editor
version: '7000.0'
latest_version: '7000.0'
status: This page documents version 7000.0. The latest version is 7000.0.
canonical: https://docs.unity.com/en-us/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo
latest_url: https://docs.unity.com/en-us/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo.md
last_updated: 2026-11-07
generated_at: 2026-11-10T02:43:10.477Z
locale: en-us
---

# ContentDirectoryLoadInfo

> What is loaded from one content directory, which of it Unity holds for the directory's root assets, and the build that produced the directory.

## Definition

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

```csharp
public sealed class ContentDirectoryLoadInfo
```

## Remarks

Pass an instance to [ContentDirectoryDiagnostics.GetContentDirectoryLoadInfo](/engine/7000.0/script-reference/unity/loading/contentdirectorydiagnostics/getcontentdirectoryloadinfo.md) to fill it, and reuse the instance across calls. The lists stay empty in release Players.

Additional Resources: [ContentDirectoryDiagnostics.GetContentDirectoryLoadInfo](/engine/7000.0/script-reference/unity/loading/contentdirectorydiagnostics/getcontentdirectoryloadinfo.md)

## Examples

```csharp
using System.Collections.Generic;
using Unity.Loading;
using UnityEditor;
using UnityEngine;

namespace BuildDocExamples
{
    // Example: find what a level loaded and did not release. Count the holds that game code keeps on
    // each content file before the level loads, and again after it unloads. A file that game code
    // holds more often afterwards is held by a Loadable that the level loaded and did not release.
    // The same asset built into two content directories has the same identity in both, so the counts
    // are kept per directory.
    public class ContentDirectoryDiagnostics_GetContentDirectoryLoadInfoExample
    {
        readonly ContentDirectoryLoadInfo m_Info = new ContentDirectoryLoadInfo();
        readonly Dictionary<(ContentDirectoryHandle, ContentFileIdentity), int> m_HoldsBeforeLevel =
            new Dictionary<(ContentDirectoryHandle, ContentFileIdentity), int>();

        public void OnBeforeLevelLoads()
        {
            m_HoldsBeforeLevel.Clear();
            foreach (ContentDirectoryHandle directory in ContentLoadManager.GetContentDirectories())
            {
                ContentDirectoryDiagnostics.GetContentDirectoryLoadInfo(directory, m_Info);
                for (int i = 0; i < m_Info.LoadState.Files.Count; i++)
                    m_HoldsBeforeLevel[(directory, m_Info.LoadState.Files[i].Identity)] = GameCodeHolds(i);
            }
        }

        public void OnAfterLevelUnloads()
        {
            foreach (ContentDirectoryHandle directory in ContentLoadManager.GetContentDirectories())
            {
                ContentDirectoryDiagnostics.GetContentDirectoryLoadInfo(directory, m_Info);
                ContentLoadState state = m_Info.LoadState;
                for (int i = 0; i < state.Files.Count; i++)
                {
                    LoadedContentFileInfo file = state.Files[i];
                    m_HoldsBeforeLevel.TryGetValue((directory, file.Identity), out int holdsBefore);
                    int notReleased = GameCodeHolds(i) - holdsBefore;
                    if (notReleased > 0)
                        Debug.LogWarning($"{notReleased} Loadable(s) not released after the level unloaded, in {NameOf(file.Identity)}");
                }
            }
        }

        // Unity holds the files of root assets for the content directory. The other holds come from game code.
        int GameCodeHolds(int fileIndex)
        {
            return m_Info.LoadState.Files[fileIndex].ReferenceCount - m_Info.RootAssetReferences[fileIndex];
        }

        // In the Editor, name the asset that the file was built from. Elsewhere, the identity is the
        // file's StableId in the ContentLayout.json file of the build that ContentDirectoryLoadInfo.BuildManifestHash names.
        static string NameOf(ContentFileIdentity file)
        {
            return ContentLoadEditorUtility.TryGetSourceAssetGUID(file, out GUID guid)
                ? AssetDatabase.GUIDToAssetPath(guid)
                : file.ToString();
        }
    }
}
```

## Properties

| Property                                                                                                             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                |
| -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| [BuildManifestHash](/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo/buildmanifesthash.md)     | Identifies the build that produced the content directory.                                                                                                                                                                                                                                                                                                                                                                                  |
| [LoadState](/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo/loadstate.md)                     | The files, scenes and dependencies loaded from the content directory.                                                                                                                                                                                                                                                                                                                                                                      |
| [RootAssetReferences](/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo/rootassetreferences.md) | For each entry of [ContentLoadState.Files](/engine/7000.0/script-reference/unity/loading/contentloadstate/files.md) in [ContentDirectoryLoadInfo.LoadState](/engine/7000.0/script-reference/unity/loading/contentdirectoryloadinfo/loadstate.md), how many of its [LoadedContentFileInfo.ReferenceCount](/engine/7000.0/script-reference/unity/loading/loadedcontentfileinfo/referencecount.md) are holds that Unity keeps on root assets. |