The Editor theme style sheet is now applied to the root of the Editor window panel instead of EditorWindow.rootVisualElement, so it no longer appears in rootVisualElement.styleSheets.
UI ToolkitChange
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
The UI Builder canvas now zooms to fit the viewport and grows to its content the first time a document opens.
UI Toolkit runtime panels no longer discard input events when the application is not focused; whether input is delivered while unfocused is now controlled by the input settings.
UI ToolkitChange
Changed how the batching runs for the completion of any remaining DebugDraw jobs still running from the previous frame in, before the streams are cleared for re-use. This may improve performance when using DebugDraw
In IL2CPP builds, the il2cpp_data folder has been moved out from the Data folder as it is now architecture specific. It now lives next to the executable.
Universal Windows PlatformChangeWindows
Moved Light Falloff Mode from the URP Asset to Graphics Settings.
URPChange
Removed a warning displayed at build time in specific Light setup that is breaking build determinism for Content Directory builds.
URPChange
Removed a warning displayed at build time in specific XR setup that is breaking build determinism for Content Directory builds.
URPChangeXR
Removed the urp_ReflProbes_Count shader variable, which no URP shader reads. Custom shaders that read it no longer compile.
URPBreaking
Renamed the Light Falloff Mode option from Linear to Quadratic.
URPChange
In IL2CPP builds, the il2cpp_data folder has been moved out from the Data folder as it is now architecture specific. It now lives next to the executable, similar to the Managed folder in CoreCLR builds.
WindowsChange
UnityEngine.XR.InputDevices.deviceDisconnected and UnityEngine.XR.InputDevices.deviceConnected, and legacy XRNode tracking-lost notifications, no longer fire across an application pause/resume for a device that is still present. InputDevice handles now stay valid across pause/resume instead of going stale. If you used those callbacks to re-acquire handles or re-apply device state on resume, use OnApplicationPause or Application.focusChanged instead.
XRChange
Changes to a Light2D's custom material are now applied to the lights that use it, without a domain reload or entering Play mode.
Fix 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-10Fix case where crash with multiple stack traces when Sprites with a high resolution get Sliced to a Grid with a small cell size in the Sprite Editor
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 SetupMaskingStencilState when rendering a SpriteRenderer whose "maskInteraction" is set to an out-of-range value
Fix crash on SpriteAtlas::GetSpritesLegacy when GetSprite is called on a Sprite Atlas V1 Variant from a project saved in Unity 6.5 or earlier
Fix 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-09Fix 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
Fix section headers for 2D/Grid Brush and 2D/Tile Palette preferences
Linked bug report
UUM-149246: Section headers "Grid Brush Flood Fill Extents" and "Grid Brush Scene View Text" don't follow the documented header-sizing convention (Preferences > 2D > Grid Brush)
Steps to reproduce: Create or open a project Open Preferences > 2D > Grid Brush Compare the font size of the page title "Grid Brush" against its section headers "Grid Brush Flood Fill Extents" and "Grid Brush Scene View Text" For reference, compare against Preferences > 2D > Physics ("Physics" title vs "Colliders"/"Contacts" headers) or Project Settings > Analysis > Project Auditor ("Project A…
Retrieved 2026-11-10Fixed "Strip 2D Unused Variants" stripping a Light 2D shader variant that is still in use, which made some 2D lights render magenta in Player builds when another light was culled.
Fixed 2D lights changing position and orientation when rotating an Android device in projects built with Vulkan and Apply display rotation during rendering enabled.
Linked bug report
UUM-147359: 2D lights change position and orientation when rotating a device and project is built with Vulkan and PreTransform enabled
How to reproduce: 1. Open the attached "IN-147968" project 2. Open Build Profiles window (File > Build Profiles) 3. Swap to Android profile 4. Make sure the "default" scene is selected in Scene List 5. Build and Run to a device 6. Rotate the device and observe the spot lights Actual result: The spot lights change position and orientation depending on the devices rotation Expected result: The s…
Retrieved 2026-11-10Fixed 2D projected shadows not rendering on some platforms
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 crash that could occur when a Sprite was destroyed while the render thread was still uploading its vertex buffer.
Fixed a crash when a Tilemap Prefab whose Scene instance has tile overrides was updated outside the Editor.
Fixed 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.
Fixed 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 a performance regression in Tilemap.SetTile and other small tile batches.
Fixed an "ArgumentException: Scene file not found" error when building with a deleted scene in the build list and Strip 2D Unused Variants enabled.
Fixed an "Index buffer element is out of bounds" error that removed a Shadow Caster 2D's shadow when its outline had a sub-shape with fewer than three edges and 2D Shadow Geometry was set to Enhanced.
Fixed an issue where a LineRenderer or TrailRenderer with Mask Interaction set to None was clipped by a Sprite Mask when another LineRenderer or TrailRenderer using the same material had Mask Interaction enabled.
Fixed an issue where a Point Light 2D lost its cookie sprite when a project saved in Unity 6.0 or 6.3 was opened in a newer version.
Linked bug report
UUM-156931: Point Light 2D loses its Cookie when a project saved in Unity 6.0 or 6.3 is opened in 6.5 or newer
Steps to reproduce: Open the attached project (saved in 6000.3.24f1) with 7000.0.0a8 and click Continue in the "Project Upgrade Required" dialog Open the "CookieUp" Scene Select "Point Light 2D with cookie" in the Hierarchy In the Inspector, open the kebab menu and select Debug Look at "Light Cookie Sprite" on the Light 2D component Actual results: "Light Cookie Sprite" is None (the cookie ref…
Retrieved 2026-11-10Fixed an issue where a Tile's StartUp method modified the tile's prefab asset when five or more tiles were refreshed.
Fixed an issue where a Tilemap did not instantiate the GameObjects of its tiles on every other scene load or Play mode entry.
Fixed an issue where cancelling animation creation after dragging multiple sprites onto a GameObject in the Hierarchy removed its existing Animator component.
Fixed an issue where creating a Tile from the Tile Palette failed when the destination folder name contained a dot.
Fixed an issue where dragging the Sprite Editor Window Zoom Level range in Preferences could set the minimum zoom below 50%.
Fixed an issue where Light2D and Shadow2D Shader Graph assets could not be dragged onto the Light 2D Material and Shadow Material fields.
Fixed an issue where lowering the maximum zoom level in the Sprite Editor Window preferences allowed the Sprite Editor to zoom out beyond the minimum zoom level.
Fixed an issue where rotating a multi-layer brush on a Hexagon Tilemap merged its Z layers and lost tiles.
Fixed an issue where the Shadow Displacement port on the Shadow Caster 2D Shader Graph target was read in the caster's local space instead of world space.
Fixed an issue where the Sprite Editor Window Zoom Level range in Preferences stayed wider after being dragged to the lower end and back.
Fixed an issue where the Tile Palette created Tile assets instead of EntityIdTile assets when the Create Tile Method preference was set to DefaultEntityIdTile.
Fixed child GameObjects of a Tile's instantiated GameObject remaining in the Scene after exiting Play mode or reloading the Scene.
Fixed crash in SpriteShapeUtility::PrepareSpriteShapeInputs when AngleRangeInfo.sprites contains an invalid index Note: Spriteshape package uses its own internal SpriteshapeGenerator and does not use UnityEngine.U2D.SpriteShapeUtility:Generate anymore. This will soon be deprecated.
Fixed Crash on SpriteAtlas::GetSpritesScripting when passing null to SpriteAtlas.GetSprites.
Fixed duplicate global light error when building a player.
Fixed editor crash in SpriteDataAccessExtensions::SetVertexCount when the count is negative.
Fixed four errors logged every frame for each Light 2D that uses a custom Material whose shader does not declare the 2D lighting keywords.
Fixed GridLayout.GetBoundsLocal(Vector3Int) returning bounds that were not centered on the cell.
Fixed inconsistent icon sharpness in the Tile Palette window.
Fixed 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 Light2D Shader Graphs gaining extra Normal, Tangent and Base Color blocks after the Material was changed in the Shader Graph Inspector.
Fixed Render Objects feature failing when depth buffer is disabled.
Linked bug report
UUM-153342: Rendering fails and errors are thrown each frame when Render Objects Renderer Feature is added with Depth/Stencil Buffer disabled
Steps to reproduce: Create and open a new URP 2D project Select the Renderer2D asset in Assets/Settings Untick the "Depth/Stencil Buffer" Add "Render Objects" Renderer Feature at the bottom Observe the Game/Scene view and Console Actual results: Game/Scene view fail to render, NullReferenceExceptions and "Render Graph Execution error" are thrown Expected results: Game/Scene views continue to r…
Retrieved 2026-11-10Fixed Shadow Caster 2D so that the shape outline is drawn in the Scene view for every Casting Option, including Self Shadow and No Shadow.
Fixed shadows from a Shadow Caster 2D that uses a Collider 2D (for example a Tilemap Collider 2D) as its casting source flickering in the Scene and Game views.
Linked bug report
UUM-147033: ShadowCaster2D shadow flickers in the Editor's Scene and Game Views when Tilemap Shadow Caster's Casting Source is set to Tilemap Collider 2D
Steps to reproduce: Open the attached project Open the "Level" scene (Assets/Scenes/Level.unity) In the Hierarchy, select the "player_idle_0" Object Move cursor in and out of Scene or Game Views Observe the shadow cast by the "Ground" Tilemap (its ShadowCaster2D has Casting Source = Tilemap Collider 2D) Actual results: Lights flicker intermittently ignoring Shadow Casters Expected results: Lig…
Retrieved 2026-11-11Fixed skinned sprites using different textures rendering with the same texture on WebGL when the SRP Batcher is enabled.
Fixed slow Apply in the Sprite Editor on textures with many sprites.
Fixed Sprite Renderer reporting itself as SRP Batcher compatible while a Material Property Block was set on it, which kept Sprite Skins on GPU deformation.
Fixed sprites and UI not rendering on some OpenGL ES devices when the 2D Renderer Depth/Stencil Buffer setting is disabled.
Fixed the active Brush changing to the last selected Brush Pick when the Brush Pick filter was toggled on and off.
Fixed the camera sorting layer texture resolution being affected by the Render Scale setting on the 2D Renderer.
Linked bug report
UUM-151723: Camera sorting layer texture is affected when changing Render Scale on Renderer2D
How to reproduce: Open the attached “IN-152053” project Open the “SampleScene” scene In the Project window navigate to the Assets\Settings folder and click on Renderer2D In the Inspector window change the Render Scale to some lower value Observe the Game view Actual result: Sprite resolution changes and it gets more pixelated Expected result: Sprite resolution does not change Reproducible with…
Retrieved 2026-11-10Fixed the Grid Selection Offset, Rotation and Scale fields in the Inspector not updating while dragging a Grid Selection gizmo in the Scene view.
Fixed the Grid Selection transform and color fields accepting input that was silently discarded when the selection contains no Tiles. The fields, selection tools and Delete Selection button are now disabled in that case.
Fixed the Open Tile Palette button and Tilemap Focus dropdown not filling the full width of their Scene view overlay.
Linked bug report
UUM-151417: "Open Tile Palette" menu item doesn't fully fill the width of its dropdown overlay in the Scene view
How to reproduce: 1. Create a new Unity project using the Universal 2D template 2. In the Project window, right-click -> Create -> 2D -> Tiles -> Hexagonal Rule Tile 3. Select the created Asset 4. In the Scene view, observe the "Open Tile Palette" Overlay Expected results: The "Open Tile Palette" menu item fills the full width of the Overlay Actual results: The "Open Tile Palette" menu item is…
Retrieved 2026-11-10Fixed the Shadow Caster 2D Casting Source dropdown showing Sprite Renderer while the shadow used the Shape Editor shape, when the Sprite Renderer was added after the Shadow Caster 2D.
Fixed the Sync Active Palette button in the Tile Palette window being cut off or hidden when the window is resized horizontally.
Linked bug report
UUM-152530: Sync Active Palette button in the Tile Palette window is easily cut off or covered due to horizontal window scaling
Steps to reproduce: Open the attached project Observe the Sync Active Palette button next to the Tile Palette drop-down Scale the Tile Palette window horizontally and observe the button Actual results: The button gets easily cut off or covered as other elements are prioritised, leaving it inoperable despite free space being present Expected results: The Sync Active Palette button remains visib…
Retrieved 2026-11-10Fixed the Tile Palette Brush Pick Overlay scrolling back to the selected Pick when you resize the Picks.
Fixed Tile Palette automatic cell size using the largest Sprite size when Sprite sizes are exact multiples of the smallest Sprite size, up to 64 times.
Fixed Tilemap Scene data changing on every save when a Tilemap contains tiles without Lock Color or Lock Transform, such as Rule Tiles.
Fixed Tilemap tile data potentially being copied incorrectly when refreshing tiles.
Fixed Tiles in the Tile Palette window rendering in solid grey after exiting Play mode when Domain Reload is disabled.
Fixed Unstable Test.
Fixed URP 2D editor-only icons being included in player builds.
Fixes 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-10Inspector - Unsaved Changes Detected pop-up shows for each Inspector window when editing Sprite Atlas asset
Platform specific overrides panel for Sprite Atlas asset does not support Undo or Redo operations
Reduced CPU cost of 2D lights and shadow casters that do not use a custom material.
The Console now shows the "More than one global light on layer" error when a 2D Light is set to Global in the Light Explorer.
The Light 2D inspector now shows an error on Freeform lights when the 2D Common package (13.0.0 or newer) is not installed, since only the light's falloff edge renders without it.
The Search window no longer renders blank for a few seconds the first time it opens.
Tilemap: Fixed Tilemap.RefreshAllTiles calling TileBase.RefreshTile twice per Tile on Tilemaps with five or more Tiles.
Undo and Redo now fully revert a pick in the Shadow Caster 2D Casting Source dropdown and the Light 2D Light Type dropdown, so the inspector shows the right fields.
Update error log when accessing index out of bounds meaningful.
Fixed the Windows player crashing on quit when a UI Automation client (e.g. a screen reader) is running.
Fixed Adaptive Performance samples in XR so the user's camera faces the sample content.
Adaptive PerformanceFixXR
Fixed Adaptive Performance settings being deleted from a Build Profile when an invalid clipboard payload was pasted into them.
Fixed indexer logic to handle when low utilization and thermal values cause performanceAction to become StateAction.Increase, indicating we have headroom to increase quality.
Adaptive PerformanceFix
Fixed pasting a Build Profile with Adaptive Performance disabled not clearing the Adaptive Performance settings of the profile it was pasted into.
Fixed pasting a clipboard that holds no Adaptive Performance settings into a Build Profile silently doing nothing instead of reporting that the clipboard cannot be pasted.
Fixed pasting a modified clipboard payload into a Build Profile adding an unrelated ScriptableObject as a hidden sub-asset and removing the existing Adaptive Performance settings.
Fixed the add and remove buttons in Adaptive Performance scaler profiles overlapping the scaler list in Project Settings and Build Profiles.
Fixed a crash in the Editor and development builds when an Experimental.AI.NavMeshQuery created with Allocator.Temp was disposed after its NavMesh had been destroyed.
AIFix
Fixed a crash when a copy of a NavQueryBuffer was used for a pathfinding operation after the buffer it was copied from had been disposed. In the Editor and in development builds such a copy now reports itself as disposed, the same as a buffer that was disposed in place.
Fixed the order of the two portal points returned for a NavMesh link, so that the first one is on the left and the second on the right also for a path that leaves the link. This applies to the results of NavWorld.GetPortalPoints and NavMeshQuery.GetPortalPoints.
Linked bug report
UUM-152707: NavWorld.GetPortalPoints() returns reversed left and right points between Link and Polygon
Steps to reproduce: Download the [Internal link] file, unarchive the project and open it. Open scene ShowPathCorridorDebug. Look at the green path drawn in the Scene view between objects Agent and FindPathExample. Alternative steps to reproduce: Create a scene with at least two NavMeshes connected through a NavMeshLink Use NavWorld to obtain a path between the two NavMeshes Use NavWorld.GetPor…
Retrieved 2026-11-11The sourceBounds from a NavMeshData object generated far from origin were incorrectly including the origin. These bounds now wrap tightly around the meshes used for building the NavMesh.
Linked bug report
UUM-152672: NavMeshData sourceBounds include the build origin when all sources are on one side of the origin position
Reproduction steps: 1. Open the attached project “NavMeshTest” 2. In the Hierarchy window select “NAV MESH 1” GameObject 3. In the Inspector window Bake the NavMeshSurface 4. In the Hierarchy window select “NAV MESH 2” GameObject 5. Repeat step 3 6. Inspect “NAV MESH 1” and “NAV MESH 2” bounds in the Game view Expected result: Bounds for both GameObjects only include geometry Actual result: Bo…
Retrieved 2026-11-10Bouncy Castle upgrade (from 1.70 to 1.86). New signing keys created by the Keystore Manager use 4096-bit RSA and a SHA256withRSA certificate, instead of 2048-bit RSA and SHA1withRSA. Existing keys are not changed.