Added: Added read-only glyph metrics API to FontAsset.
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Added: Added LayoutRebuilder.IsLayoutRebuildPending and LayoutGroup.IsLayoutPending() to check whether a UI element still has a pending layout rebuild.
uGUIAPI change
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).
uGUIBreaking
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).
uGUIBreaking
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.
uGUIBreaking
Added: Added api for measuring Min-content text.
UI ToolkitAPI change
Added: Added APIs FindPanelRenderer and FindUIDocument.
UI ToolkitAPI change
Added: Added support to capture a VisualElement to a RenderTexture.
UI ToolkitAPI change
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.
UI ToolkitAPI change
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.
UI ToolkitAPI change
Added: Added UxmlSerializedDataPropertyDrawer, UxmlAttributeField, and UxmlAttributeFieldDecorator to support custom property drawers for UI Toolkit elements in the Inspector.
UI ToolkitAPI change
Added: Experimental VisualElement Components.
UI ToolkitAPI change
Added: Added 4 overloads for DrawProceduralIndirect that add a count parameter and an optional indirect count buffer for Multi Draw Indirect.
URPAPI change
Changed: Added CLI args to Integration and Runtime test runners to select target browser and platform.
UTRAPI change
Removed: Removed the deprecated MovieTexture API.
VideoBreaking
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.
WebAPI change
Added: Added performance.measureUserAgentSpecificMemory to web diagnostics overlay to calculate used JS memory.
WebAPI change
Added Burst and Collections as dependency for com.unity.2d.tilemap package.
Changed Tilemap component data structure for better compatibility with jobs.
2DChange
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.
2DChange
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.
2DBreaking
URP's three internal 2D shadow shaders are merged into a single five-pass shader; no user-visible rendering change.
2DChange
Updated the Android Gradle Plugin (AGP) version from 9.0.0 to 9.1.1.
AndroidChange
Updated the Gradle version shipped with the Editor from 9.1.0 to 9.3.1.
AndroidChange
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).
Asset PipelineServer
Updated Color preferences doc page.
DocumentationChange
Changed the Project Auditor Suppressed Issues preference to also accept spaces as a delimiter between issue IDs, in addition to commas and semicolons.
EditorChange
Disabled static batching by default for new projects.
EditorChange
GTK : Added Support for variable condition transition drag n drop.
EditorChange
GTK : Fixed an issue where the + button was not focusable.
EditorChange
GTK: Fixed an issue where the transition counter was off center.
EditorChange
Project Auditor: Added the ability to skip built-in analyzers for ones that have been migrated to the Project Auditor Rules package.
EditorChange
Project Auditor: bumped Rules package minimum version to 2.0.0.
EditorChange
Project Auditor: moved Domain Reload issues to Code pages.
EditorChange
Project Auditor: new severity icons/colors.
EditorChange
Project Auditor: removing opt-in checkbox for Roslyn.
EditorChange
Removed the NetCoreRuntime from the Editor install.
EditorBreaking
Tweaked some Surface Cache quality presets.
EditorChange
Updated the main toolbar UX, new design for toggles and better visualization of the groups of elements.
EditorChange
Added an option to hide Unity-Namespaced Systems in the System window.
EntitiesChange
Added HasHierarchy tag component to TransformRef when it becomes part of a hierarchy.
EntitiesChange
Bumped the scene serialized CurrentFileFormatVersion version number because the alignment of Entity is changed to 8 bytes.
EntitiesChange
Display meta chunk entities matching queries in System window and Search window.
EntitiesChange
Entities: com.unity.charactercontroller is now embedded as a core package in Unity.
Fixed the incorrect icon for shared and chunk components in the System window.
EntitiesChange
HierarchyColor from the Subscene monobehavior is now an error-level obsolete member.
EntitiesChange
Moved the ImHex .hexpat generation used for binary debugging of .entities files, from the UNITY_DOTS_IMHEX script define to an editor preference (Entities > Debugging).
EntitiesChange
Migrate Surface Cache GI to use Ray Query instead of Ray Tracing Shaders.
GIChange
Require "Raw" target for mesh vertex and index buffers. To achieve this, the "Default Mesh Buffer Target" setting should be set to "Raw" in Project Settings > Graphics.
GIChange
Surface Cache global illumination now uses only the LOD level selected by the LOD Group's Global Illumination LOD, instead of every level.
GIChange
Passing null to the dataType parameter in the method DataTypeStyleMapper.Register now means to not show an icon at all for a type instead of showing a default icon.
Graph ToolkitChange
Deprecated the Baked Occlusion Culling authoring workflow in the Editor. New projects no longer expose its authoring UI, while existing projects retain the workflow and baked data and display a deprecation notice. Consider migrating to GPU Occlusion Culling where supported.
GraphicsBreaking
Moved mesh deformation compute shaders to from default built-in resources to built-in extra resources.
GraphicsChange
Removed un-unused UnityAot2 Hashes.
IL2CPPBreaking
Added a -CPULightmapper=no command line switch to the Windows Editor installer that skips installing components only the CPU Progressive Lightmapper requires, currently the end-of-life Microsoft Visual C++ 2010 runtime.
Removed assertions from ToFileDescriptor.
Linked bug report
UUM-145761: Linux Editor intermittently aborts with a `ToFileDescriptor` assertion (`fd < sysconf(_SC_OPEN_MAX)`) during a `NamedPipeServerStream` async accept while compiling scripts in batchmode
On Linux/Docker CI build, the editor sometimes crashes when building and during test runs. The crash happens when ToFileDescriptor is called inside pal_utilities.h:160 with the message 'Assertion `fd < sysconf(_SC_OPEN_MAX) && "Requested file descriptor exceeds maximum number of files allowed to be open at a time."' failed.'` Logging open fds shows this is {}not{} exceeding the maximum. Steps …
Retrieved 2026-11-09Changed the run mode of a local player (Scenario Control / Manual Control) to be stored per developer instead of in the scenario asset, so it no longer travels with the asset in version control. Existing scenarios reset to Scenario Control the first time you open them in this version.
MultiplayerChange
Unity Transport: The RoslynAnalyzerFix asset post-processor (and its assembly) have been removed from the package. This deprecated hook did not serve a purpose anymore since the analyzer was removed from the package in version 2.5.0.
Always automatically generate the NetcodeConfig singleton. This is a breaking change for any project that uses EntityManager.CreateSingleton<NetcodeConfig>() to create the singleton explicitly. You can update your code to use SystemAPI.GetSingleton<NetcodeConfig>() instead.
Netcode for EntitiesBreaking
N4E is now a regular editor-independent package, where previously it was built-in.
Netcode for EntitiesChange
Added localization package 2.0. This version is designed to work with the built in localization module.
Package
Changed the signature window to be more consistent and display more information about the installed package.
Package ManagerChange
Help boxes learn more links are at the end of the text in the Package Manager window.
Package ManagerChange
Marked the Analytics Library package (com.unity.analytics) as deprecated. Migrate to Unity Analytics (com.unity.services.analytics).
Updated the icons for Installed, Refresh, Installed as dependency and removed the icons for available for import, and available for download.
Package Manager
Changed the default value of PhysicsBodyDefinition.transformWriteMode from Off to Interpolation. Existing PhysicsCoreSettings2D assets are unaffected; only newly created assets use the new default.
Physics 2DChange
Changed PhysicsWorld.Explode so that it no longer applies an impulse to trigger shapes by default.
Physics 2DChange
Loading a prefab or scene that stores prefab data in the format written by Unity 3.3 and earlier now logs a deprecation warning naming the asset. Save the asset to store it in the current format.
PrefabsChange
Added an infobox to Build Profiles window that informs you of the new Managed Code Variants feature. This infobox can be permanently dismissed by pressing the "Dismiss" button.
ScriptingChange
Added CoreCLR runtime, .NET base class library, and managed Unity engine PDBs to the public symbol server.
ScriptingChangeServer
Changed the Dictionary Inspector warning about ignored entries to offer both Select First and Select All buttons when more than one entry is ignored.
Dictionary fields can now use a class or struct key, or a struct value, that contains a SerializeReference field.
SerializationChange
Renamed the Reset to Defaults item in the Dictionary Inspector header context menu to Reset Layout, to make it clear that it restores only the drawer layout and not the dictionary contents.
Moved the Particle Shader Graph sample from the HDRP package to the Shader Graph package.
ShadergraphChange
Always show the UXML document link and asset actions in the element inspector header outside the UI Stage.
UI ToolkitChange
AttributeOverrides are now shown as disabled during main stage authoring.
UI ToolkitChange
Changed the Text attribute field to 3 lines by default instead of 1 when editing in the UI Builder or Scene inspector.
UI ToolkitChange
Changed theme style sheets to rank above Unity's built-in styles regardless of selector specificity; the previous behavior can be restored with the Legacy Theme Priority setting in Project Settings > UI Toolkit.
UI ToolkitChange
Allow skipping of shadow, prepass, opaque, and transparent passes when the culling/layer masks would mean nothing would be drawn.
URPChange
Mata passes for GI no longer requires _EMISSION but checks purely from gi material flags.
URPChange
Renamed the Light Falloff Mode option from Linear to Quadratic.
URPChange
Reordered the Screen Space Ambient Occlusion pass when After Opaque is enabled. In previous versions, it used to run in the BeforeRenderingTransparents point in the frame. Now it runs in the AfterRenderingOpaques point in the frame.
URPChange
Moved the "Restart VFX" shortcut from Shift+Space to Slash.
Provided clear messaging that custom light probes are not fully supported in VFX Graph yet.
Further reduce the code size of Web builds using the "Disk Size" Code Optimization settings. Testing across multiple projects and devices showed that compared to the default "Shorter Build Time" setting, "Disk Size" reduced code size by an average of 8.75%, with this change the reduction is now an average of 21.35%. As always these settings are a trade-off between size and runtime performance, the same testing showed that the average frame time performance regression grows from 2.13% to 4.56% with the performance regression being reduced when LTO is enabled.
WebChange
Move progressive asset loading data files to Build directory of player build output.
WebChange
Updated deprecation message for WebAssembly 2023.
WebChange
DirectStorage is now enabled by default in new projects for the Windows Standalone player.
WindowsChange
Windows builds now link the Visual C++ runtime dynamically instead of statically, and Unity copies the required Visual C++ runtime DLLs (such as vcruntime140.dll and msvcp140.dll) into the build output next to the executable. A new "Copy Visual C++ runtime libraries" option under Publishing Settings (on by default) lets you skip copying them if you install the redistributable another way, for example via your own installer or a distribution platform such as Steam.
Windows
Updated XR Core Utilities package to version 6.0.0 in order to match Unity version.
XRChange
Updated XR Legacy Input Helpers package to version 6.0.0 in order to match Unity version.
XRChange
XR Management package version updated to 6.0.0.
XRChange
Fixed a case where in In 3D Editor mode, textures did not generate Sprite subassets when imported as SpriteSprite Generation.
Linked bug report
UUM-142920: In 3D editor mode, textures do not generate Sprite subassets when imported as Sprite
Steps to reproduce: Open 3D project or switch Behaviour Mode to 3D in Project Settings > Editor Add texture/image to Assets In Inspector, switch Texture Type from Default to Sprite Observe no Sprite subasset generated Note: In 2D editor mode, Sprite subasset is generated even when Sprite Mode is Multiple by default Actual results: Expected results: Reproducible with versions: 6000.6.0a5 Not re…
Retrieved 2026-11-09Fixed an issue where changing the SpriteAtlas option in EditorSettings results in render artifacts.
Fixed an issue where Tilemap.tilemapPositionsChanged and tilemapTileChanged callbacks didn't invoke when SetTiles changed only the transform or color of a tile.
Fixed an issue where TilemapRenderer inherited normal maps from other Tiles when a Tile did not have a normal map.
Linked bug report
UUM-145359: Tiles inherit Normal Maps from other Tiles when no Normal Map is assigned
How to reproduce: 1. Open the attached “IN-145873” project 2. Open the scene “SampleScene” 3. Observe the Scene view Actual result: Pipe tiles have Walkway tiles' normal texture rendered on them Expected result: Pipe tiles should not have any normal texture rendered on them Reproducible with: 6000.0.0f1, 6000.0.78f1, 6000.3.18f1, 6000.4.12f1, 6000.5.1f1, 6000.6.0a7 Reproducible on: Windows 11 …
Retrieved 2026-11-09Fixed case of Tile Palette Brush Picks overlay turning itself off in the Scene View when the user clears the search field in the overlay (for example by pressing Backspace).
Fixed case where Sprite is not rendered in a SRP Batcher when Sprite Mask is removed after it was previously set.
Fixed duplicate Sprite Editor window settings appearing in project settings.
Fixed error message when entering fast playmode with Sprite Editor Window changes.
Linked bug report
UUM-146790: Exception "AssetDatabase.ForceReserializeAssets cannot be used when in play mode" is thrown when entering Play Mode with unapplied Sprite Editor changes and Reload Domain disabled
Steps to reproduce: Create a new Universal 2D project via Unity Hub Edit > Project Settings > Editor > "Enter Play Mode Settings": enable Enter Play Mode Options and disable Domain Reload In the Project Browser right click and Create > 2D > Sprites > Triangle and Select the texture In the Inspector click "Open Sprite Editor" (or Window > 2D > Sprite Editor) Draw a Cube Sprite container in the …
Retrieved 2026-11-09