Added: Added "PhysicsHingeJoint.currentSpeed", the speed body B is currently turning relative to body A.
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Added: Added "PhysicsQuery.CircleAndCapsule", "PhysicsQuery.CircleAndSegment", "PhysicsQuery.CircleAndPolygon", "PhysicsQuery.CapsuleAndSegment", "PhysicsQuery.CapsuleAndPolygon" and "PhysicsQuery.PolygonAndSegment" so every pair of geometries can be queried in either order.
Added: Added "PhysicsShape.ContactFilterModeOverride", "PhysicsShape.ContactFilterGroupModeOverride", and the "contactFilterModeOverride" and "contactFilterGroupModeOverride" properties on "PhysicsWorld" and "PhysicsWorldDefinition", so each world can choose its own contact filter modes.
Physics 2DAPI change
Added: Added "PhysicsShape.SetBatchDefinition" to set the same definition on a batch of shapes.
Physics 2DAPI change
Added: Added "PhysicsShape.SetCallbackTarget", "PhysicsBody.SetCallbackTarget" and "PhysicsJoint.SetCallbackTarget" to set the same callback target on a batch of objects.
Physics 2DAPI change
Added: Added "PhysicsShape.SetPhysicsGroup" to set the same physics group on a batch of shapes.
Physics 2DAPI change
Added: Added "PhysicsWorld.bounceIterations", "PhysicsWorld.bouncePropagation" and the matching "PhysicsWorldDefinition" properties, to control how bounces are resolved.
Added: Added "PhysicsWorld.callbackTargetCount" to get the number of distinct callback targets in a world.
Physics 2DAPI change
Added: Added "PhysicsWorld.disableDrawOverride" so a world always draws with its own draw settings while the Editor draw override is enabled.
Added: Added "WorldProfile.bounceImpulses", also shown in the 2D Physics Profiler module.
Changed: Changed "PhysicsWorld.bounceIterations" and "PhysicsWorldDefinition.bounceIterations" to have a minimum of one, given by the new "PhysicsConstants.MinBounceIterations".
Physics 2DAPI change
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 "PhysicsShape.ContactFilterGroupMode.Filtering" in favor of "PhysicsShape.ContactFilterGroupMode.Isolate".
Physics 2DBreaking
Deprecated: Deprecated "PhysicsWorld.elementDepth" and "PhysicsWorld.SetElementDepth3D()" in favor of "PhysicsWorld.drawDepth" and "PhysicsWorld.SetDrawDepth3D()". The old names upgrade automatically.
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.
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
Removed: Removed the TestRunProfiler API from UnityEditor.TestTools.TestRunner.Api, which was added in an earlier 6000.7 pre-release.
Test FrameworkBreaking
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-09Added: 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
Added: Added GameWindow API support for Windows.
WindowsAPI change
Fully enforce Sprite Frame editing capability. Overriding locks field are now removed.
2DBreaking
Updated the Universal 2D project template to include 2D Physics Core settings.
2DChange
Adaptive Performance settings assets are now generated in Assets/Settings/AdaptivePerformance, and existing assets in Assets/Adaptive Performance are moved there automatically.
Adaptive PerformanceChange
Removed support for Mono-based Android players
AndroidBreaking
Renamed the "Build App Bundle (Google Play)" build setting to "Build App Bundle".
Updated the Android Gradle Plugin (AGP) version from 9.0.0 to 9.1.1.
AndroidChange
Removed support for loading animation clips saved before Unity 1.6; open and re-save such clips in an older version of Unity to keep their curves.
AnimationBreaking
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.
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
Removed the Low option from the Managed Stripping Level Player setting. Projects that use Low are upgraded to Minimal when opened, which might increase build size.
Code StrippingBreaking
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
Moved Transparency Sort settings out of the Built-In tab in Graphics settings.
EditorChange
Removed macOS x64 Editor and Player support.
EditorBreakingmacOS
Removed support for Mono-based Editor
EditorBreaking
Shortcut actions and global input handlers now run outside of OnGUI, so Event.current is null inside them; use ShortcutArguments.sourceEvent to read the triggering event.
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
EntityManager.CopyEntitiesFrom no longer makes structural changes in the source world.
EntitiesChange
GameObjects now have entities with chunk storage in the active World, so entity queries match them like any other entity.
EntitiesChange
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
Renamed the blob asset analyzer diagnostics EA0001, EA0002, EA0003 and EA0009 to UAC0040, UAC0041, UAC0042 and UAC0043, which now also check code in the Entities engine 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
When a world has several managed systems of the same type, GetExistingSystemManaged and GetOrCreateSystemManaged now return the most recently created one, matching ISystem lookups.
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-11Lightmapping.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-11Realtime Reflection Probes no longer use a baked fallback cubemap when Realtime Reflection Probes is disabled in Quality settings, including cubemaps baked before a probe was switched to Realtime.
GIChange
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