Disabled Built-in Render Pipeline rendering paths, render black instead.
GraphicsChange
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Removed obsolete Built-in Render Pipeline components and shaders from UI, and marked them not supported in the inspector
GraphicsBreaking
Sprite Renderer no longer applies GPU blend shapes when Mesh Deformation is set to CPU in Player Settings.
GraphicsChange
Removed a warning displayed at build time in specific XR setup that is breaking build determinism for Content Directory builds.
HDRPChangeXR
On an unfolded iPhone Duo, Display.main was the outer panel instead of the panel the game renders on, so rendering to Display 2 replaced the game and Screen.fullScreen returned false. (PLAT-22932)
iOSChange
Remove public keyword from topMostController variable as it is not part of public API
iOSChange
Removed support for x64 and Universal Simulator architectures.
iOSBreaking
Changed NativeList and UnsafeList to preserve only the first Length elements when capacity grows. Data written beyond Length through the raw pointer is no longer retained across a reallocation.
Removed the license type from the Unity Editor window title on Linux, so that it matches the window title on macOS and Windows.
LinuxWindowsmacOS
Changed the Multiplayer Center genre selection screen to show the game genres side by side as cards, each with its architecture, complexity, and cost, so they can be compared at a glance.
MultiplayerChange
Removed UnityWebRequest.enableProfilerBodyCapture. The Web Requests Profiler module now captures request and response bodies whenever the Profiler is recording, so there is no longer a setting to turn on. Remove any assignment to this property; no replacement is needed.
NetworkingUUM-153039
NGO (com.unity.netcode.gameobjects) package was updated in the editor manifest to newest major version (3.0.0).
The content of com.unity.collections has been moved to an engine module, and the package is just a shim with typeforwarders, so it no longer has any dependencies. If you were relying on it having them, you'll need to depend on them yourself explicitly (most notably, com.unity.test-framework).
Changed Package Manager to use the production environment when the Editor's cloud environment is set to a value other than production or staging.
Package ManagerChange
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
"ManifoldPoint.normalVelocity" is now only guaranteed to be measured when the shape is bouncy or hit events are enabled, and can read zero otherwise.
"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-10A contact cancelled by a pre-contact callback is now updated every simulation step, so the callback is called every step while the shapes stay in contact.
Changed the default "PhysicsShapeDefinition" to enable "contactEvents" and "triggerEvents", and the default "PhysicsChainDefinition" to enable "triggerEvents", so a shape only needs "isTrigger" enabled to detect other shapes.
Contact and hinge joint solving were restructured, so simulation results can differ slightly from previous versions.
Polygons created from vertices now keep vertices that are much closer together before welding them, and "PhysicsWorld.minPolygonEdgeLength" now reports this smaller distance.
Remove deprecated BIRP support for PhysicsCore2D renderer.
Physics 2DBreaking
Setting "PhysicsWorld.maximumLinearSpeed" or "PhysicsWorldDefinition.maximumLinearSpeed" below "PhysicsConstants.MinMaximumLinearSpeed" now raises it to that minimum.
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
Removed the upgrade path for prefab data saved by Unity 3.3 or earlier, so prefab instances and per-object overrides in projects that old no longer survive being opened. Unity 6.7 warns when it loads an asset in that format.
PrefabsBreaking
Changed the Editor so that it emits C# compiler warnings for immutable packages, such as packages installed from a package registry. Warnings from these packages now appear in the Console window and the Editor log.
ScriptingChange
Removed forced managed GC after a (single-mode) scene load in the CoreCLR Player.
ScriptingBreaking
Removed forced managed GC after a scene load in the CoreCLR Editor.
ScriptingBreaking
UNITY_64 preprocessor symbol no longer gets defined when building for any platform.
ScriptingChange
DEVELOPMENT_BUILD preprocessor symbol no longer gets defined when building for any platform. Preprocessor symbols DEBUG, ENABLE_ASSERTIONS and ENABLE_PROFILER now only get defined in appropriate managed code variants (debug, checked and instrumented, respectively). BuildOptions.ForceEnableAssertions, CodeAnalysisFlags.DevelopmentBuild, ScriptCompilationOptions.DevelopmentBuild, ScriptCompilationOptions.Assertions and AssemblyBuilderFlags.DevelopmentBuild have been removed: script compilation is now only affected by the managed code variant.
ScriptingBreaking
Changed text serialized files so they begin with a %UNITY format version directive, which makes an earlier version of Unity report an explicit error when opening a file saved in this version instead of loading it with missing data.
SerializationChange
Text serialized files such as scenes and prefabs no longer start with a %UNITY 7.0 line, so Unity 6 can open them again, and files saved with that line still load.
SerializationChange
Reflected function fallback keys now use the fully qualified signature (this will not impact correct usage of the ProviderKey hint).
ShadergraphChange
Removed the Back To Front and Front To Back Render Face options from URP Shader Graphs. Shader Graphs and materials saved with these options now render front faces only.
ShadergraphBreaking
Surface shaders are now marked as deprecated.
ShadersBreaking
UnityEditor.Rendering.CoreBuildData.developmentBuild is now an error to use instead of a warning. It was already obsolete since Unity 6.6 and always returned false. Use UnityEditor.Rendering.CoreBuildData.useDiagnosticChecks instead.
SRP CoreChange
Fixed Is.Not.AllocatingGCMemory() under-reporting allocations when another allocation constraint runs inside the measured delegate.
Test FrameworkChange
Updated FreeType to version 2.15.0, which adds support for mirrored Apple Color Emoji glyphs on macOS and slightly changes how text renders in the Hinted Smooth and OS Default font rendering modes.
TextChangemacOS
The URP sample template no longer includes a copy of the TextMesh Pro essential resources and uses the built-in resources from the uGUI package instead.
TextMeshProChange
Built-in USS filter functions with missing or wrong-typed arguments now use the filter's default values and log a warning instead of an error.
Changed Constant Physical Size panels to account for the Game view's Low Resolution Aspect Ratios setting when resolving scale.
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-09Changed z-index transitions between auto and an integer to switch at the midpoint of the transition instead of interpolating from 0, to match CSS.
UI ToolkitChange
Fixed grid line placement and -unity-slice properties not recording or playing back in UI Animation Clips.
UI ToolkitChange
Importing localization shared table data that has two entries using the same key now renames the duplicate and logs a warning.
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
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.