Release Notes Search

Search changes, fixes, and known issues across Unity releases.

Clear
Filters
254,355 matches
7000.0.0a12100 shown
Changed: The batch and span setters on "PhysicsBody", "PhysicsShape" and "PhysicsJoint", along with "PhysicsWorld.Simulate", "PhysicsWorld.DrawShapes", "PhysicsSpace.SetBatchProxyAABB" and "PhysicsSpace.SetBatchProxyCategories", now return the number of items ignored because they were invalid and log a single warning when any are ignored.
Physics 2DAPI change
Deprecated: Deprecated "PhysicsWorld.elementDepth" and "PhysicsWorld.SetElementDepth3D()" in favor of "PhysicsWorld.drawDepth" and "PhysicsWorld.SetDrawDepth3D()". The old names upgrade automatically.
Physics 2DBreakingUUM-155044
Deprecated: Deprecated the "useScale" parameter of "PhysicsMath.GetRelativeMatrix2D", which had no effect; use the overload without it, or "PhysicsMath.GetRelativePose2D" to build a matrix with the scale you need.
Physics 2DBreakingUUM-157407
Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
QNXAPI change
Changed: EditorSettings.forceAssetUnloadAndGCOnSceneLoad has been renamed to EditorSettings.unloadUnusedAssetsOnSceneLoad and no longer forces a managed garbage collection.
ScriptingAPI change
Changed: Changed SerializedProperty.numericType to report the underlying integer width instead of Unknown for FileSize, Type*, and EntityId fields.
SerializationAPI change
Changed: Changed SerializedProperty.propertyType to report Integer instead of Generic for fields whose serialized type is FileSize or Type*.
SerializationAPI change
Added: Exposed additional resource binding information for shader compilation results.
ShadersAPI change
Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmup.WarmupShader method is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmup.WarmupShaderFromCollection method is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.Experimental.Rendering.ShaderWarmupSetup struct is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.Shader.WarmupAllShaders method is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.ShaderVariantCollection.isWarmedUp property is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.ShaderVariantCollection.warmedUpVariantCount property is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.ShaderVariantCollection.WarmUp method is now deprecated.
ShadersBreaking
Deprecated: UnityEngine.ShaderVariantCollection.WarmUpProgressively method is now deprecated.
ShadersBreaking
Added: Enabled Upscaling Framework by default.
SRP CoreAPI change
Added: Added TerrainData.maxHeightmapResolution, minAlphamapResolution, maxAlphamapResolution, minBaseMapResolution, maxBaseMapResolution, minDetailResolutionPerPatch and maxDetailResolutionPerPatch, the limits that the resolution setters clamp values to.
TerrainAPI change
Added: Added TerrainRegion and TerrainEditUtility to sculpt heights and paint terrain layers by height and slope inside a rectangle, disc or path from scripts, and to read the heightmap samples and alphamap texels such an area covers. They are designed for authoring.
TerrainAPI change
Changed: Selectable.s_Selectables changed from a Selectable array to List<Selectable>.
uGUIAPI change
Obsoleted: Selectable.s_SelectableCount is now obsolete. Use Selectable.allSelectableCount instead.
uGUIBreaking
Added: Added LocalizedFontAsset, a localized reference to a FontAsset that lets UI Toolkit text change font with the locale.
UI ToolkitAPI change
Added: Added ScrollView.touchScrollDirection to make the content move opposite to the pointer when dragged with touch or a tracked device.
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-09
UI ToolkitAPI changeUUM-139596
Added: Added the BoxShadow and StyleBoxShadow types, and the IStyle.boxShadow and IResolvedStyle.boxShadow properties.
UI ToolkitAPI change
Added: Added the PlayerLoop.PreUpdate.UIElementsPreparePanelRenderers player loop system, which attaches PanelRenderer content to its panel before Update.
UI ToolkitAPI change
Added: Added IFormattingExtensionsToggle to Smart Strings, which lets a source skip formatter extensions for the placeholder it resolved.
UI ToolkitAPI change
Added: Added ParserSettings.SelectorCharFilter and SelectorFilterType to Smart Strings. Set the filter to VisualUnicodeChars to use characters from any script in a selector.
UI ToolkitAPI change
Added: Added PluralRules.RestoreDefault to Smart Strings, which restores the built-in pluralization rules.
UI ToolkitAPI change
Added: Enabled Upscaling Framework by default.
URPAPI change
Deprecated: Deprecated UnityEditor.WebGLLinkerTarget and WebGLWasmArithmeticExceptions enums.
WebBreaking
Obsoleted: Marked PlayerSettings.WebGL.memorySize as obsolete.
WebBreakingWebGL
Fully enforce Sprite Frame editing capability. Overriding locks field are now removed.
2DBreaking
Removed support for Mono-based Android players
AndroidBreaking
Renamed the "Build App Bundle (Google Play)" build setting to "Build App Bundle".
AndroidChangeUUM-151967
Updated the Android Gradle Plugin (AGP) version from 9.0.0 to 9.1.1.
AndroidChange
Removed support for x64 and Universal Simulator architectures.
Apple TVBreaking
Asset Import: Changed how Unity picks an asset's main object, so that objects an AssetPostprocessor adds with AddObjectToAsset no longer replaces the object the importer produces. To make an added object the main object, call AssetImportContext.SetMainObject in the postprocessor. Unity reimports all assets the first time you open an existing project, and some assets might have a different main object afterwards. Refer to the Unity 7.0 upgrade guide.
Asset ImportChangeUUM-153090
Updated the asset import pipeline, so Unity reimports all assets in a project the first time you open it in this version of the Editor.
Asset ImportChange
ContentBuildFlags.DevelopmentBuild has been removed. This flag was used to indicate whether content builds should serialize scripts with development build processor symbols. However, development builds no longer have any special preprocessor symbols and thus this flag did not do anything anymore.
Build PipelineBreaking
IProcessSceneWithReport and PostProcessSceneAttribute APIs are deprecated. Use AssetPostprocessor.OnProcessScene instead so that AssetImportContext and its built-in dependencies registration is available to better support incremental builds.
Build PipelineBreaking
bee_backend now requires glibc >= 2.35 on linux (ubuntu 22.04 or later)
Build SystemChangeLinux
Burst now compiles macOS players for Apple Silicon only, and the Burst AOT Settings no longer offer x64 CPU architectures for macOS.
BurstChangemacOS
Changed Burst's default LLVM version to 23.
BurstChange
Structs with auto-layout can now be used in Burst as long as they are not a part of a method's signature or a job's struct. This allows tuples to be used in structs that don't cross the managed-native barrier again.
BurstChange
Update the native Selection API to use ObjectPtr instead of ObjectRef.
CoreChange
Environment.Exit() now throws a PlatformNotSupportedException on the CoreCLR scripting backend. Use Application.Quit() instead.
CoreCLRChange
Removed experimental label from CoreCLR
CoreCLRBreaking
Changed the Editor preferences folder to Editor-7.x, which is seeded on first launch by copying the existing Editor-5.x folder so that earlier Editor versions keep their own preferences.
EditorChange
Changed the Project Auditor Suppressed Issues preference to also accept spaces as a delimiter between issue IDs, in addition to commas and semicolons.
EditorChange
Changing the Editor theme, Editor font, Editor language to now prompts for restart the Editor.
EditorChange
Fast Enter Play Mode is now the default for projects created with the "-createProject" editor command line argument, from script code and for projects without a ProjectSettings/EditorSettings.asset file. Affected projects will now default to the "Reload Scene Only" option when entering and exiting playmode in the editor rather than "Reload Domain and Scene". Existing projects are unaffected. For more information see the online documentation:
EditorChange
[Configuring how Unity enters Play mode](https://docs.unity3d.com/7000.0/Documentation/Manual/configurable-enter-play-mode.html)
ChangesChange
[Enter Play mode without domain reload](https://docs.unity3d.com/7000.0/Documentation/Manual/domain-reloading.html)
ChangesChange
[Domain and scene reload execution order reference](https://docs.unity3d.com/7000.0/Documentation/Manual/configurable-enter-play-mode-details.html).
ChangesChange
Removed macOS x64 Editor and Player support.
EditorBreakingmacOS
Removed support for Mono-based Editor
EditorBreaking
The macOS character palette shortcut now only opens the palette while a text field is being edited.
EditorChangemacOS
Diagnostic Data Collection is now enabled by default for every build profile, including in upgraded projects, unless a build profile explicitly disables it.
Engine DiagnosticsChange
Diagnostic data is no longer collected in the Editor when the active build profile targets a platform that doesn't support Diagnostics.
Engine DiagnosticsChange
Editor crash and exception reporting to Diagnostics now follows the Diagnostic Data Collection setting of the active build profile.
Engine DiagnosticsChange
Removed the Diagnostics page from Project Settings > Services. Diagnostic Data Collection is now configured for each build profile in the Build Profiles window, and Project Settings > Services describes the diagnostic data that Unity collects.
Engine DiagnosticsBreaking
The Diagnostic Data Collection setting in the Build Profiles window now offers Enabled and Disabled, and disabling it no longer asks for confirmation.
Engine DiagnosticsChange
Changed the *Open in Hierarchy item in the Entity Inspector component menu to open the Hierarchy window filtered by the component type, and removed the Open in Search Window* item.
EntitiesBreaking
Remove the obsolete HierarchyColor field in Subscene
EntitiesChange
Removed the deprecated Entities Hierarchy window. Use the Hierarchy window to view and search entities instead.
EntitiesBreaking
Removed the Entities package dependency on the Audio module. Projects that use Entities can now remove the Audio module.
Entities
The Unity.Entities runtime now ships in the engine as UnityEngine.EntitiesModule. Its public types are forwarded from the Unity.Entities package assembly, so existing code keeps compiling.
EntitiesChange
UnityObjectRef<T> now has a public EntityId property and a FromEntityId factory method.
EntitiesChange
Bake Reflection Probes no longer bakes Custom reflection probes, because it replaced their cubemap with a generated one. To bake a Custom probe, use the Bake button in its Inspector.
Linked bug report
UUM-141083: An "Unknown reflection probe mode: 1" error is thrown when baking Realtime Reflection Probes

Steps to reproduce: Create and open a new URP 3D project Create a Reflection Probe in the Hierarchy Change its type to "Realtime" in the Inspector Open Window -> Rendering -> Lighting Next to "Generate Lighting" press the dropdown and select "Bake Reflection Probes" Observe the Console Actual results: An "Unknown reflection probe mode: 1 UnityEditor.GenericMenu:CatchMenu (object,string[],int)"…

Retrieved 2026-11-11
GIChangeUUM-141083
Lightmapping.BakeReflectionProbe now returns false and logs an error for Realtime reflection probes instead of writing a cubemap.
Linked bug report
UUM-141083: An "Unknown reflection probe mode: 1" error is thrown when baking Realtime Reflection Probes

Steps to reproduce: Create and open a new URP 3D project Create a Reflection Probe in the Hierarchy Change its type to "Realtime" in the Inspector Open Window -> Rendering -> Lighting Next to "Generate Lighting" press the dropdown and select "Bake Reflection Probes" Observe the Console Actual results: An "Unknown reflection probe mode: 1 UnityEditor.GenericMenu:CatchMenu (object,string[],int)"…

Retrieved 2026-11-11
GIChangeUUM-141083
Removed the Progressive CPU Lightmapper and the Lightmapper dropdown from the Lighting window; the lightmapper now follows the Default Light Baker setting in the Graphics settings, and scenes that used the Progressive CPU Lightmapper are automatically upgraded to the Progressive GPU Lightmapper.
GIBreaking
Surface Cache Global Illumination debug views are now displayed as a resizable Rendering Debugger overlay and no longer replace the scene's global illumination.
GIChange
Added an error banner in the main window if the project is using Built-in Render Pipeline
GraphicsChange
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
Disabled Built-in Render Pipeline rendering paths, render black instead.
GraphicsChange
Removed a warning displayed at build time in specific XR setup that is breaking build determinism for Content Directory builds.
HDRPChangeXR
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.
KernelChangeUUM-129943
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).
PackageChangecom.unity.netcode.gameobjects
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).
Packagecom.unity.collectionscom.unity.test-framework
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.
Physics 2DChangeUUM-154721
"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-10
Physics 2DChangeUUM-156367
Remove deprecated BIRP support for PhysicsCore2D renderer.
Physics 2DBreaking
Setting "PhysicsWorld.maximumLinearSpeed" or "PhysicsWorldDefinition.maximumLinearSpeed" below "PhysicsConstants.MinMaximumLinearSpeed" now raises it to that minimum.
Physics 2DChangeUUM-154721
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

Pick your Unity version

Unity Releases compares releases against the version your project is on. Picking it now keeps Compare versions focused on what changes between where you are and where you might be going.