Release Notes Search

Added: Implemented window focus, visibility, and destruction event system APIs in Windowing.

Added: Added CoreCLR ScriptingImplementation enum value exposing CoreCLR player support.

Added: Added the IVariantSelector interface, which you can implement to define custom variants for the localization system.

Added: New public API, Detach(node) and DetachChildren(node) on Hierarchy and HierarchyCommandList. A detached node keeps its data map entry but is unreachable from Root.

Added: New public API, IHierarchyNodeTypeHandlerViewModelState, and GetOrCreateHandlerState<T>, TryGetHandlerState<T> and DestroyHandlerState on HierarchyViewModel, for node type handler state that belongs to a single view model. HierarchyNodeTypeHandlerBase.SearchBegin, SearchMatch and SearchEnd gained overloads taking the HierarchyViewModel running the search.

Added: [Scripting] IL2CPP code coverage support.

Deprecated: Deprecated PlayerSettings.gpuSkinning. Use PlayerSettings.meshDeformation instead.

Deprecated: HierarchyNodeTypeHandlerBase.SearchBegin(HierarchySearchQueryDescriptor), SearchMatch(in HierarchyNode) and SearchEnd() are obsolete. Use the overloads that take a HierarchyViewModel, since handlers are shared by every view model on a hierarchy.

Removed: Deprecated Hierarchy.GetAllNodeTypeHandlersBase has been removed.

Removed: Deprecated Hierarchy.GetAllNodeTypeHandlersBaseCount has been removed.

Removed: Deprecated Hierarchy.RegisterNodeTypeHandler has been removed.

Removed: Deprecated Hierarchy.SortChildren(HierarchyNode, bool) has been removed.

Removed: Deprecated Hierarchy.UnregisterNodeTypeHandler has been removed.

Removed: Deprecated HierarchyCommandList.SortChildren(HierarchyNode, bool) has been removed.

Removed: Deprecated HierarchyFlattened.Hierarchy has been removed.

Removed: Deprecated HierarchyFlattenedNodeChildren has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase constructor taking a Hierarchy parameter has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.ChangesPending has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.Dispose has been removed.

Removed: Deprecated HierarchyNodeTypeHandlerBase.IntegrateChanges has been removed.

Removed: Deprecated HierarchyViewModel.ClearFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAllFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.DoesNotHaveAnyFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithAllFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithAnyFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithoutAllFlags has been removed.

Removed: Deprecated HierarchyViewModel.EnumerateNodesWithoutAnyFlags has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAllFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithAnyFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAllFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetIndicesWithoutAnyFlags(HierarchyNodeFlags, Span<int>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAllFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithAnyFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAllFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.GetNodesWithoutAnyFlags(HierarchyNodeFlags, Span<HierarchyNode>) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAllFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlags(HierarchyNode, HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlags(HierarchyNodeFlags) has been removed.

Removed: Deprecated HierarchyViewModel.HasAnyFlagsCount has been removed.

Removed: Deprecated HierarchyViewModel.Hierarchy has been removed.

Removed: Deprecated HierarchyViewModel.SetFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewModel.ToggleFlags(HierarchyNode, HierarchyNodeFlags, bool) has been removed.

Removed: Deprecated HierarchyViewNodesEnumerable has been removed.

Removed: Deprecated HierarchyWindow.InitializingView has been removed.

Removed: Removed the deprecated HierarchyViewModel.HierarchyFlattned.

Added: Added SetBufferData to Raster/Unsafe command buffers and allow SetComputeBufferData for all APIs.

Obsoleted: Deprecating UnityEngine.Rendering.Pool and standarizing UnityEngine.Pool across SRP packages.

Added: Added TestRunProfiler custom spans API.

Added: Added read-only glyph metrics API to FontAsset.

Added: Added LayoutRebuilder.IsLayoutRebuildPending and LayoutGroup.IsLayoutPending() to check whether a UI element still has a pending layout rebuild.

Deprecated: Marked the PositionAsUV1, TMP_TextElement_Legacy, FaceInfo_Legacy, TMP_Glyph, TMP_Sprite, KerningPair and KerningTable classes as deprecated (with a warning). Marked the GlyphValueRecord_Legacy struct as deprecated (with a warning). Marked the EventHandle enum as deprecated (with a warning). Marked TMP_SpriteAsset.spriteInfoList as deprecated (with a warning). Marked Scrollbar.ClickRepeat(PointerEventData eventData) deprecated (with a warning).

Obsoleted: Marked the TMP_FontUtilities class as obsolete (with an error). Marked the KerningPairKey struct as obsolete (with an error). Marked the EventSystem.SetUITookitEventSystemOverride method as obsolete (with an error). Marked the Graphic.m_CachedMesh, Graphic.m_CachedUvs and Graphic.useLegacyMeshGeneration members as obsolete (with an error).

Removed: Removed BaseMeshEffect.ModifyMesh(Mesh mesh). Removed BaseRaycaster.priority property. Removed EventSystem.lastSelectedGameObject property. Removed Graphic.OnPopulateMesh(Mesh m). Removed Image.eventAlphaThreshold property. Removed InputField.onValueChange property. Removed InputField.ScreenToLocal(Vector2 screen). Removed IGraphicEnabledDisabled interface. Removed IMeshModifier.ModifyMesh(Mesh mesh). Removed Mask.OnSiblingGraphicEnabledDisabled(). Removed PointerEventData.worldPosition and PointerEventData.worldNormal properties. Removed RaycastResult.document property. Removed Selectable.allSelectables property. Removed ShaderUtilities.isInitialized and ShaderUtilities.GetShaderPropertyIDs(). Removed StandaloneInputModule.InputMode enum. Removed StandaloneInputModule.inputMode, StandaloneInputModule.allowActivationOnMobileDevice and StandaloneInputModule.forceModuleActive properties. Removed StandaloneInputModule.ForceAutoSelect(). Removed TextMeshPro.textContainer property. Removed TMP_FontAsset.fontInfo property. Removed TMP_Text.enableWordWrapping and TMP_Text.enableKerning properties. Removed TMP_Text.SetText(string sourceText, bool syncTextInputBox = true). Removed TouchInputModule class.

Added: Added api for measuring Min-content text.

Added: Added APIs FindPanelRenderer and FindUIDocument.

Added: Added support to capture a VisualElement to a RenderTexture.

Added: Added the public UnityEngine.EventCommandNames class, which provides the command name constants that the Editor sends with its command events, such as Copy, Paste, and FrameSelected.

Added: Added z-index USS property support for controlling the stacking order of overlapping elements within a stacking context. Enable via Project Settings > UI Toolkit > Experimental Renderer Features > Enable Z-Index.

Added: Added IFormattingExtensionsToggle to Smart Strings, which lets a source skip formatter extensions for the placeholder it resolved.

Added: Added ParserSettings.SelectorCharFilter and SelectorFilterType to Smart Strings. Set the filter to VisualUnicodeChars to use characters from any script in a selector.

Added: Added PluralRules.RestoreDefault to Smart Strings, which restores the built-in pluralization rules.

Added: Added UxmlSerializedDataPropertyDrawer, UxmlAttributeField, and UxmlAttributeFieldDecorator to support custom property drawers for UI Toolkit elements in the Inspector.

Added: Experimental VisualElement Components.

Added: Added 4 overloads for DrawProceduralIndirect that add a count parameter and an optional indirect count buffer for Multi Draw Indirect.

Changed: Added CLI args to Integration and Runtime test runners to select target browser and platform.

Removed: Removed the deprecated MovieTexture API.

Added: Added new "Maximum Size Reduction" and "Maximum Size Reduction with LTO" Code Optimization settings. When enabled this will further optimize compiled IL2CPP code as well as apply extra link time optimizations (these are distinct from LTO). Testing across multiple projects and devices showed that compared to the default "Shorter Build Time" setting, "Maximum Size Reduction" reduces code size by an average of 28.50% at the cost of 5.25% frame time performance regression.

Added: Added performance.measureUserAgentSpecificMemory to web diagnostics overlay to calculate used JS memory.

Added Burst and Collections as dependency for com.unity.2d.tilemap package.

Changed Tilemap component data structure for better compatibility with jobs.

Refactored URP 2D shadow shaders into a consolidated multi-pass form with named passes (Self, UnshadowMark, UnshadowUnmark, ProjectedSelf, ProjectedUnshadow). Groundwork for upcoming custom-shader and ShaderGraph master node support; no user-visible rendering change.

Renamed the Sprite "Physics Shape" API and Sprite Editor tab to "Physics Outline" to avoid confusion with PhysicsCore2D's PhysicsShape. The old API is deprecated but still works and auto-upgrades.

URP's three internal 2D shadow shaders are merged into a single five-pass shader; no user-visible rendering change.

Redesigned the Insets section in Player Settings to show a table with per-inset controls for Visible, Overlapping, and Appearance.

Updated the Android Gradle Plugin (AGP) version from 9.0.0 to 9.1.1.

Updated the Gradle version shipped with the Editor from 9.1.0 to 9.3.1.

Introducing a number of command-line arguments and environment variables related to the cache server (making it possible to disable upload and download from/to the cache server of specific types of importers).

Updated Color preferences doc page.

Updated the UI system comparison table to indicate that UITK now supports animation and in-scene authoring.

Changed the Project Auditor Suppressed Issues preference to also accept spaces as a delimiter between issue IDs, in addition to commas and semicolons.

Disabled static batching by default for new projects.

GTK : Added Support for variable condition transition drag n drop.

GTK : Fixed an issue where the + button was not focusable.

GTK: Fixed an issue where the transition counter was off center.

Project Auditor: Added the ability to skip built-in analyzers for ones that have been migrated to the Project Auditor Rules package.

Project Auditor: bumped Rules package minimum version to 2.0.0.