Updated Color preferences doc page.
DocumentationChange
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Updated the UI system comparison table to indicate that UITK now supports animation and in-scene authoring.
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
The macOS character palette shortcut now only opens the palette while a text field is being edited.
EditorChangemacOS
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
Changed AsyncGPUReadback to reject a readback whose destination NativeArray is still in use by a running job, and report the error through the callback instead of proceeding.
GraphicsChange
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
PerformanceTestRunInfo.json and PerformanceTestRunSettings.json are no longer generated during player builds that do not include test assemblies, as they are only read by performance tests running inside the player. Stale files left behind by an aborted test build are removed before such builds instead of being included in them.
Performance Test FrameworkBreaking
"PhysicsComposer.AddLayer", "PhysicsComposer.ToPolygons", "CircleGeometry.ToPolygons" and "CapsuleGeometry.ToPolygons" now log the standard validation warning instead of throwing "ArgumentOutOfRangeException" when given no geometry, fewer than three vertices or an invalid "curveStride".
Linked bug report
UUM-156367: Crash on MimallocAllocator::Allocate when CircleGeometry.ToPolygons and PhysicsComposer.AddLayer are called with a curveStride of NaN
How to reproduce: 1. Open the attached “IN-155847“ project 2. In the top Menu bar, click “Repro” > “1 - CircleGeometry.ToPolygons with curveStride NaN (CRASHES the Editor)” 3. Observe the crash Reproducible with: 6000.3.17f1, 6000.3.26f1, 6000.6.6f, 6000.7.0b4, 7000.0.0a8 Could not test with: 6000.0.84f1 (“Repro” Menu item would not appear), 6000.3.15f1 (could not solve errors from downgrading…
Retrieved 2026-11-10Changed 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
Surface shaders are now marked as deprecated.
ShadersBreaking
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
Changed touch dragging of ScrollView content on world-space panels so the content follows the finger pixel for pixel, regardless of the Pixels Per Unit setting.
Linked bug report
UUM-139596: UITK WorldSpace ScrollView behaviour on Mobile
R.e. ScrollView behaviour in Worldspace UI on Mobile devices: On touch devices, the scrolling should work as follow: * When we touch the scroll bar and move it up and down, it should follow your finger. And the grid should move in the opposite direction. That works as expected in the video But when you touch the grid and drag it around, the grid should follow your finger, and the scroll bar sh…
Retrieved 2026-11-09Allow 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
Fix case where ideo is not rendered when the VideoPlayer GameObject is disabled and re-enabled after playback starts while using Material Override render mode
Fix Crash on "pqInit" when SpriteShapeUtility.Generate is given a closed shape with two coincident control points. Note this API is specific to an old Spriteshape package and will be deprecated in an upcoming version. Please refer to SpriteShapeGenerator.cs in the Spriteshape package for any future use of Triangulation.
Fix Crash on SpriteAtlas::GetSpritesScripting when passing null to SpriteAtlas.GetSprites
Fix editor crash in SpriteDataAccessExtensions::SetVertexCount when the count is negative
Fix issues where Unsaved Changes Detected pop-up are doubled after editing Sprite Atlas asset if it was open on multiple Inspector windows and choosing the Discard option
Fixed a "No script asset for ShadowCasterPath" warning when you undo or redo a Shadow Caster 2D shape edit in Play mode.
Linked bug report
UUM-152935: "No script asset for ShadowCasterPath." warning is thrown after performing Undo action for ShadowCaster shape changes in Play Mode
Steps to reproduce: Open the attached project Open the SampleScene Enter Play mode Switch to Scene View Select the Triangle object in the Hierarchy Press the Edit Shape Button for the ShadowCaster2D component in the Inspector window Change the ShadowCaster's shape Perform an Undo action Observe the Console window Actual results: Undo action is performed correctly, however "No script asset for …
Retrieved 2026-11-10Fixed 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 a crash when entering Play Mode with a Tilemap whose tiles re-enter the Tilemap API during StartUp.
Fixed a NullReferenceException thrown every frame by a 2D Light of type Provider whose Light2DProvider returns no mesh.
Linked bug report
UUM-153965: Light2DProvider throws NullReferenceException every frame in minimal implementation scenarios due to default mesh provider returning a null
Steps to reproduce: Open the attached project Open the PB1_AlreadyBroken Scene Observe the Console window Actual results: NullReferenceException errors are thrown every frame Expected results: Default provider returns a mesh primitive or an empty mesh Reproducible with versions: 6000.5.0a8. 6000.6.3f1, 6000.7.0b3, 7000.0.0a1 Can’t test with versions: 6000.5.0a7 and earlier (Light2DProvider cla…
Retrieved 2026-11-12Fixed a NullReferenceException when a Light 2D created from a script is set to Freeform without a shape path.
Linked bug report
UUM-154810: "NullReferenceException" error is thrown in LightUtility.GenerateShapeMesh when a Light 2D created from a script is set to Freeform
Steps to reproduce: 1. Create a new Unity project using Universal 2D Template 2. Add attached “QAFreeformNRE.cs” script to project and add it to any GameObject in Hierarchy window 3. Enter Play Mode 4. Observe the Console window Actual results: “NullReferenceException: Object reference not set to an instance of an object” error is thrown in the Console window Expected results: no exception is …
Retrieved 2026-11-11Fixed 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 ArgumentException when using overlay camera in 2D Renderer.
Linked bug report
UUM-148111: "ArgumentException: An item with the same key has already been added" is thrown when the Base and Overlay cameras of a 2D camera stack use different Renderers
Reproduction steps: Open the attached "IN-145480_REPRO" project Open the "Assets/Scenes/SampleScene.unity" scene Make sure both the Game view and the Scene view are visible Enter Play Mode Observe the Console Actual result: The Console continuously prints "ArgumentException: An item with the same key has already been added" Expected result: No error is thrown Reproducible with: 6000.0.0b11, 60…
Retrieved 2026-11-10Fixed 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 child GameObjects of a Tile's instantiated GameObject remaining in the Scene after exiting Play mode or reloading the Scene.
Fixed duplicate global light error when building a player.
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-09Fixed exception when creating new Tile asset when doing a drag and drop on a Tile Palette that is open for edit.
Linked bug report
UUM-143122: MissingReferenceException during image import to Tile Palette when in Tile Palette Edit mode
Steps to reproduce: Create and open a new 2D UPR project Create a Triangle Sprite png in the Project tab (Create -> 2D Sprite -> Triangle) Create a Tilemap grid in the Hierarchy Open it in the Tile Palette window Create a new Tile Palette Enable the Tile Palette Edit mode Drag the Triangle png into the canvas Create an asset from the png Observe the Console and Tile Palette Actual results: "Mi…
Retrieved 2026-11-09Fixed IndexOutOfRangeException errors thrown while editing a Freeform Light 2D shape whose edges overlap.
Linked bug report
UUM-153123: IndexOutOfRangeException Errors are thrown when editing 2D Freeform light and shape's edges overlap
Steps to reproduce: Open the attached project Open the SampleScene Select the Freeform Light 2D object in the Hierarchy In the Inspector window, click the Edit Shape button In the Scene view, Edit the shape in a way, that edges overlap each other (Reference video attached) Actual results: Multiple IndexOutOfRangeException errors are thrown while editing the Shape Expected results: No errors or…
Retrieved 2026-11-10Fixed intermediate texture not created when requested by render pass.
Linked bug report
UUM-145892: RenderGraph Blit/Copy sample throws "texture handle does not have a valid descriptor" error when the Copy Render Feature is used with the 2D Renderer
How to reproduce: Open attached "IN-145916_Rendererror.zip" project Enter Play mode Observe the Console Actual result: "Render Graph Execution error", ArgumentException "texture handle does not have a valid descriptor" errors are thrown in the Console Expected result: No errors are thrown Reproducible with: 6000.0.0f1, 6000.0.78f1, 6000.3.18f1, 6000.5.1f1, 6000.6.0b1, 6000.7.0a1 Reproducible o…
Retrieved 2026-11-09Fixed issue where Texture is not updated in TilemapRenderer when edits are made in the SpriteEditor.
Fixed Light2D memory leak when unloading scenes - the runtime-created light mesh is now properly destroyed when the component is destroyed.
Linked bug report
UUM-143650: Light2D causes memory leak when unloading scene with UnloadSyncAsync
How to reproduce: Open the attached "IN-144029" project Open the SampleScene Open the Profiler. Window >Analysis> Profiler Enter Play mode Observe the Memory Profiler and see initial memory usage Hold spacebar for 30-70 seconds Observe the Memory Profiler and see how memory usage changed Actual Result: Light2D does not destroy runtime created mesh, causing a memory leak Expected result: Light2…
Retrieved 2026-11-09Fixed LineRenderer not initializing correctly when toggling enable on game object.
Linked bug report
UUM-147747: LineRenderer using URP SpriteLitDefault Material becomes invisible when animating its "Material._Renderer Color" property and disabling and reenabling the GameObject
Steps to reproduce: 1. Create a new 2D URP project 2. Open the “SampleScene” scene 3. Create a new GameObject with Animator and LineRenderer components 4. Create a Material using the Universal Render Pipeline/2D/Sprite-Lit-Default shader, and assign any texture to the “Diffuse” slot 5. Assign the Material to the LineRenderer. 6. Create an animation for the GameObject 7. Add the LineRenderer's …
Retrieved 2026-11-10