docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Understand SerializeReference limitations

    The SerializeReference attribute serializes polymorphic references, but it has limitations when the referenced type becomes unavailable. When this happens, Unity Behavior marks assets as having Managed references with missing types.

    A type loss can occur in the following cases:

    • When you rename, move, or delete classes to refactor a code.
    • Assembly changes due to compilation issues or missing dependencies.
    • Different team members use different package or code versions.

    For more information about SerializeReference, refer to the Unity’s SerializeReference documentation.

    Additional resources

    • How SerializeReference limitations affect Behavior assets
    • Mitigation systems in Behavior
    In This Article
    Back to top
    Copyright © 2025 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)