Fixed slow mass removal of ray tracing instances in unified raytracing.
GIImprovement
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Surface Cache GI supports Entities.
GIImprovement
Reduced the metadata storage size of methods and parameters.
IL2CPPImprovement
Reduced memory consumption in Release builds. In Release builds, Profiler.GetTotalAllocatedMemoryLong() and Profiler.GetTotalReservedMemoryLong() now report the size the allocator actually reserved rather than the size that was requested, so a higher value than before does not mean that more memory is used.
iOSImprovement
Improved source generator logging for long log lines.
Netcode for EntitiesImprovement
Added a dedicated ProfilerCategory.PhysicsCore2D profiler category. The PhysicsCore2D markers report under it.
Physics 2DImprovement
Changed chain-segment ghost edges to draw as dimmed lines.
Physics 2DImprovement
Changed joint drawing to a uniform scheme of an anchor line, anchor points and a spring target marker, with configurable world draw colors.
Physics 2DImprovement
Improved the PhysicsCore2D SDF debug-draw shaders for better overall performance, per-pixel accuracy, and reduced aliasing when viewing at low angles.
Physics 2DImprovement
Increased the PhysicsWorld.DrawThickness maximum from 5 to 10 pixels.
Physics 2DImprovement
Merged the Physics Core 2D project-settings pages into a single page and the settings asset Inspector now shows the full settings for direct editing.
Physics 2DImprovement
Improved our Lifecycle system to allocate less memory on hot paths.
Updating unlisted shader properties via Material Set[Type] APIs mark the material dirty.
ShadersImprovement
Improved RgbToHsv accuracy.
Improved the tween engine with performance optimizations. Removed duplicate tween engine implementations from the TMP assemblies.
uGUIImprovement
Improved accuracy of time measurements in USS Stats window (experimental).
UI ToolkitImprovement
Improved USS selector matching performance for complex selectors and for elements that match many selectors in the same stylesheet.
UI ToolkitImprovement
Shader Graph support for UIToolkit Filters.
UI ToolkitImprovement
Reduced memory consumption in Release builds. In Release builds, Profiler.GetTotalAllocatedMemoryLong() and Profiler.GetTotalReservedMemoryLong() now report the size the allocator actually reserved rather than the size that was requested, so a higher value than before does not mean that more memory is used.
VisionOSImprovement
Reduced memory consumption when UnityDefaultAllocator is used in Release builds. Profiler.GetTotalAllocatedMemoryLong() and Profiler.GetTotalReservedMemoryLong() now report the size the allocator actually reserved rather than the size that was requested when UnityDefaultAllocator is used in Release builds, so a higher value than before does not mean that more memory is used.
WebImprovement
Graphics: Improved GPU performance of stencil deferred point and spot light draws by specializing the per-light fragment shader per light type, letting point lights skip cone-angle math and spot lights skip a runtime shadow-map-face branch.
XRImprovement
QuadViews: Allow LUT information to be reused within inner/outer views.
XRImprovement
QuadViews: Defer the submission of render commands to the final inner quad view pass to improve XR CPU performance.
XRImprovement
Added: Added CompileSdkSpec Gradle DSL classes.
AndroidAPI change
Added: Added PlayerSettings.Android.compileSdkVersion to set the compile API level independently of the target API level, including sub-integer (major.minor) precision.
AndroidAPI change
Added: Added a real-time counterpart to ControlContext.SendMessage for the Scriptable Audio Pipeline. This is a binary breaking change, but it's source compatible.
AudioBreaking
Added: Added seeking support to scriptable processors and audio clips used as generators.
AudioAPI change
Added: Scriptable processors: added GeneratorInstance.CreationParameters and RootOutputInstance.CreationParameters; deprecated ProcessorInstance.CreationParameters and its implicit conversions (to be removed in a following version).
AudioBreaking
Added: Added right click menu support for state machine.
EditorAPI change
Added: Added the UnityEditor.EditorDialogEvents API, which raises dialogWillShow and dialogDismissed events when a native or custom modal dialog appears in the Editor. External tooling can use these events to detect that the Editor's main thread is blocked by a dialog instead of appearing hung.
EditorAPI change
Added: GTK : Custom state machine conditions can now customize their row in the transition inspector.
EditorAPI change
Removed: Baking managed components and managed shared components is no longer supported. Baker.AddComponentObject, Baker.AddSharedComponentManaged, and Baker.SetSharedComponentManaged are now compile errors. Convert your data to unmanaged IComponentData / ISharedComponentData (use UnityObjectRef<T> to reference UnityEngine.Object instances) and bake it with the unmanaged AddComponent / AddSharedComponent APIs.
EntitiesBreaking
Removed: The EntityCommandBuffer/ParallelWriter APIs for managed IComponentData and managed ISharedComponentData are now compile errors.
EntitiesBreaking
Added: Let render pipelines opt out of the baked divide-by-PI convention.
GIAPI change
Deprecated: Deprecated both TerrainExtensions.UpdateGIMaterials overloads. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated CombineInstance.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated DynamicGI.indirectScale, DynamicGI.isConverged, DynamicGI.materialUpdateTimeSlice, DynamicGI.synchronousMode, DynamicGI.updateThreshold, DynamicGI.SetEmissive, and DynamicGI.SetEnvironmentData. DynamicGI.UpdateEnvironment is not deprecated. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated LightingSettings.realtimeGI and LightingSettings.realtimeEnvironmentLighting. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated LightmapParameters.clusterResolution, LightmapParameters.irradianceBudget, LightmapParameters.irradianceQuality, LightmapParameters.isTransparent, LightmapParameters.modellingTolerance, LightmapParameters.stitchEdges, and LightmapParameters.systemTag. LightmapParameters.resolution is not deprecated, because it also sets the resolution the Progressive Lightmapper bakes terrain at. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated MeshRenderer.enlightenVertexStream. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated Renderer.realtimeLightmapIndex and Renderer.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated RendererExtensions.UpdateGIMaterials. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated Terrain.realtimeLightmapIndex and Terrain.realtimeLightmapScaleOffset. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Deprecated: Deprecated UnityEditor.Lightmapping.realtimeGI. Enlighten realtime Global Illumination will be removed in a future release.
GIBreaking
Added: Added a new API to access the root VisualElement of States.
Graph ToolkitAPI change
Added: Added an API to edit Group Conditions.
Graph ToolkitAPI change
Added: Added StateMachine.OnStateMachineChanged() public API.
Graph ToolkitAPI change
Added: Extend ITransition to add abilities to manage ITransitionRules.
Graph ToolkitAPI change
Added: Extend the StateMachine class to add the ability to manage transitions between states.
Graph ToolkitAPI change
Added: Added a new DeviceOrientationSensor device that provides feature parity with UnityEngine.Input.deviceOrientation.
Input SystemAPI change
Added: Added internal plumbing for the Input System package to be able to extract Device Orientation similar to Input Manager.
Input SystemAPI change
Added: Introducing user module version for UnityAPI module for Swift project type.
iOSAPI change
Removed: The obsolete managed GhostPresentationGameObjectPrefab component is now a hard error ([Obsolete(..., true)]) and no longer functional. Use the unmanaged UnmanagedGhostPresentationGameObjectPrefab instead, which references the prefabs through UnityObjectRef<GameObject>.
Netcode for EntitiesBreaking
Added: Added "Get()" extension method to all Physics "object" types to allow users to work around not being able to use a setter property on a returned object without first assigned to a local variable. Added to PhysicWorld, PhysicsBody, PhysicsShape, PhysicsChain, PhysicsJoint and all concrete PhysicsJoints.
Physics 2DAPI change
Added: Added a selectedDrawing property to PhysicsBody, PhysicsShape and PhysicsJoint, batch SetSelectedDrawing methods, and PhysicsWorld.ClearDrawSelected, so individual objects can be drawn persistently when the world is drawn.
Physics 2DAPI change
Added: Added an autoAxis option to the slider and wheel joint definitions that derives the joint axis from the joint anchors when the joint is created.
Physics 2DAPI change
Added: Added batch setters for user data, owner user data, contact filter and surface material on PhysicsShape, PhysicsBody and PhysicsJoint.
Physics 2DAPI change
Added: Added: PhysicsBody, PhysicsShape and PhysicsJoint now each have a "drawTarget" property, selecting which Unity editor views (Scene view, Game view or both) the object is drawn into when the world is drawn.
Physics 2DAPI change
Changed: Added an optional Display Name property to ProfilerCounterDescriptor for improved readability.
ProfilerAPI change
Deprecated: Deprecated PlayerSettings.gpuSkinning. Use PlayerSettings.meshDeformation instead.
ScriptingBreaking
Added: Added TestRunProfiler custom spans API.
Test FrameworkAPI 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 Burst and Collections as dependency for com.unity.2d.tilemap package.
Changed Tilemap component data structure for better compatibility with jobs.
2DChange
Project Auditor: new severity icons/colors.
EditorChange
Removed the NetCoreRuntime from the Editor install.
EditorBreaking
Tweaked some Surface Cache quality presets.
EditorChange
Added HasHierarchy tag component to TransformRef when it becomes part of a hierarchy.
EntitiesChange
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
Added localization package 2.0. This version is designed to work with the built in localization module.
Package
Marked the Analytics Library package (com.unity.analytics) as deprecated. Migrate to Unity Analytics (com.unity.services.analytics).
AttributeOverrides are now shown as disabled during main stage authoring.
UI ToolkitChange
Mata passes for GI no longer requires _EMISSION but checks purely from gi material flags.
URPChange
Provided clear messaging that custom light probes are not fully supported in VFX Graph yet.
Fixed TilemapRenderer rendering regressions for Individual mode and Hexagonal/Isometric Chunk mode.
Fixed editor crash when baking a nav mesh that includes objects that result in an extremely large bounds.
Linked bug report
UUM-134462: Crash with multiple stack traces when baking a specific Navmesh Surface
How to reproduce: 1. Open the attached “IN-130259” project 2. Open the “Eldara” scene 3. In the Hierarchy, search for “nav“ 4. Click on the “NavMesh Surface” GameObject 5. In the Inspector, click “Bake” 6. Wait for ~5 minutes 7. Observe the crash Reproducible with: 2.0.5 (6000.0.38f1), 2.0.10 (6000.0.0b13, 6000.0.68f1, 6000.3.9f1, 6000.4.0b9, 6000.5.0a7) Could not test with: 6000.0.0b12 (could…
Retrieved 2026-11-09Added Scripting documentation for PlayerSettings.Android.compileSdkVersion.
AndroidFix
Auto-fill compileSdkVersion on existing-project upgrade.
AndroidFix
Fixed an approximately 7 MB native memory leak per Application.Unload cycle when using GameActivity.
AndroidFix
Fixed an intermittent crash on Adreno GPUs using OpenGL ES that could occur while UI Toolkit meshes were being updated, caused by the same out-of-bounds write. (UUM-148139) First seen in 6000.7.0a4.
Fixed an intermittent crash on Adreno GPUs using OpenGL ES that could occur while UI Toolkit text was being generated, caused by the same out-of-bounds write. (UUM-147072) First seen in 6000.7.0a3.
Fixed an intermittent crash on Adreno GPUs using OpenGL ES, caused by an out-of-bounds write while reading a shader's uniform block bindings. (UUM-147815) First seen in 6000.7.0a4.
Fixed Android version labels to match Google's naming.
Fixed System Bars UI columns miss alignment on big window sizes. (UUM-150348) First seen in 6000.7.0a6.
Improved the "Missing Required API Level" dialog.
Re-enabled Java heap leak check in AndroidPlayerUnloading integration tests.
AndroidFix
Fixed an issue where "NullReferenceException" would be thrown in the Console when interacting with the transition editor in the Animator Controller Transition inspector. (UUM-149141) First seen in 6000.7.0a4.
Fixed an issue where Animator window's Layers dropdown (in compact mode) would be extremely wide when layers have very long names.
Fixed GUIStyle warnings when clicking on \"Add Properties\" in Animation Window.
Linked bug report
UUM-148497: Animation window "Add Property" dropdown throws GameSkin style warnings after Undo/Redo on UI Toolkit UI Element
Steps to reproduce: 1. Create new Unity project using Universal 3D Template 2. In Hierarchy create Label object (Right-click > UI Toolkit > Standard Elements > Label) 3. Open Animation window (Window > Animation > Animation) 4. Select “Label” in Hierarchy window and press “Create” in Animation window to create Animation clip 5. Add Color Property via “Add Property” button 6. Undo changes 7. Re…
Retrieved 2026-11-10Fixed Null Reference Exception when selection Object drop destination from multiple choices in the dopesheet editor.
Linked bug report
UUM-148386: NullReferenceException is thrown when dragging a Sprite into the Animation window on a GameObject with multiple serialized Sprite properties
How to Reproduce: 1. Open the attached “IN-149264” project 2. Open “SampleScene” 3. Open the “TestScript.cs” file 4. Note that public Sprite spriteA; is present in the “TestScript.cs” file 5. In Unity, From the Hierarchy window, select the “TestObject” GameObject 6. From Asset, drag and drop the “PlayerSprites.png” to the Animation window 7. From the pop-up select “SpriteRenderer” 8. Observe t…
Retrieved 2026-11-10Fixed an issue where performance could degrade and eventually fail when the Accelerator was under heavy load.
Bug was already fixed. Added a test.
Fixed AudioSettings.driverCapabilities returning undefined value when using the Enhanced Audio Foundation.
Fixed crash when pausing AudioRandomContainer containing streaming clips on some platforms.
Corrected reporting of player build flags in analytics. (UUM-144697) First seen in 6000.7.0a5.
Fixed an issue where VideoClips referenced by Content Directory builds failed to load at runtime on macOS.
Fixed the Build Profile Scene List being emptied when pasting a different settings section onto it. (UUM-147103) First seen in 6000.7.0a2.