Obsoleted: Obsoleted Unity.Assertions.Assert in favour of UnityEngine.Assertions.Assert, which it forwarded to. The API Updater converts existing uses.
EntitiesBreaking
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Removed: Removed the Entities Journaling window and the EntitiesJournaling API, deprecated in Unity 6.5; use the IDebugOnAdded and IDebugOnRemoved component lifecycle callbacks instead.
EntitiesBreaking
Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).
GIBreaking
Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).
GIBreaking
Deprecated: LightingSettings.lightmapper is now deprecated. The lightmapper in use is determined by the Default Light Baker setting in the Graphics settings (UnityEditor.Rendering.EditorGraphicsSettings.defaultLightBaker).
GIBreaking
Obsoleted: LightingSettings.Lightmapper.ProgressiveCPU now produces a compiler error; use LightingSettings.Lightmapper.ProgressiveGPU or LightingSettings.Lightmapper.UnityComputeGPU instead.
GIBreaking
Added: Added Graphics.disableDepthAndStencilBuffers, a read-only property that returns whether Disable Depth and Stencil Buffers is enabled in Player Settings.
GraphicsAPI change
Added: Added SystemInfo.supportsPrecompiledGraphicsStateStats, which reports whether the current graphics device can return precompiled graphics state statistics. It is false on every graphics device that does not expose them, and the statistics are all zero in that case.
GraphicsAPI change
Added: Added UnityEngine.Rendering.PrecompiledGraphicsState.GetStats, which returns statistics of the precompiled graphics states usage for the current graphics device (if supported).
GraphicsAPI change
Deprecated: Deprecated the C# APIs associated with Baked Occlusion Culling. They continue to work but now produce compiler warnings and will be removed in a future release. Consider migrating to GPU Occlusion Culling where supported.
GraphicsBreaking
Deprecated: Deprecated the OcclusionArea and OcclusionPortal component APIs. They continue to work but will be removed in a future release. Consider migrating to GPU Occlusion Culling where supported.
GraphicsBreaking
Added: Enabled Upscaling Framework by default.
HDRPAPI change
Changed: PBXProject build property setters (SetBuildProperty, AddBuildProperty, UpdateBuildProperty and their ForConfig variants) now throw ArgumentNullException when given a null value.
iOSAPI change
Changed: SDKROOT, SUPPORTED_PLATFORMS, TARGETED_DEVICE_FAMILY, *_DEPLOYMENT_TARGET and ARCHS are no longer defined in the trampoline Xcode templates - the player build is now their only source. In the Swift trampoline these settings are written at project level only, so the targets inherit them.
iOSAPI change
Added: Added MemoryLabel.Create
KernelAPI change
Added: Added LicensingUtility.HasPro, HasEduLicense, IsPersonal, and GetAuthToken, which replace the deprecated license helpers on UnityEditorInternal.InternalEditorUtility.
LicenseBreaking
Added: EntitlementGroupInfo.TryGetExpirationUtc (not yet used, except in tests) for reading an entitlement group's expiry as a DateTime.
LicenseAPI change
Changed: Moved the licensing API from the UnityEditor.Experimental.Licensing namespace to UnityEditor.Licensing. Existing code is updated automatically when the project is imported.
LicenseAPI change
Deprecated: Deprecated the license helper methods on UnityEditorInternal.InternalEditorUtility.
LicenseBreaking
Removed: Removed UnityEditorInternal.InternalEditorUtility.GetLicenseFlags, which already produced a compile error when used.
LicenseBreaking
Added: Added "currentSpringForce" to "PhysicsDistanceJoint", "PhysicsSliderJoint" and "PhysicsWheelJoint", and "currentSpringTorque" to "PhysicsHingeJoint".
Added: Added "origin" overloads to the cast queries "PhysicsWorld.CastShape", "PhysicsWorld.CastShapeProxy" and "PhysicsWorld.CastGeometry", so the cast geometry can be authored in a local frame and positioned by a world-space point.
Added: Added "origin" overloads to the overlap queries "PhysicsWorld.TestOverlapShape", "PhysicsWorld.OverlapShape", "PhysicsWorld.TestOverlapShapeProxy", "PhysicsWorld.OverlapShapeProxy", "PhysicsWorld.TestOverlapGeometry" and "PhysicsWorld.OverlapGeometry", matching the cast queries.
Added: Added "PhysicsBody.drawDepth" and "PhysicsBody.SetDrawDepth3D()" to set the depth a body is drawn at when it has no transform object.
Added: Added "PhysicsBodyDefinition.drawTarget" and "PhysicsBodyDefinition.drawDepth" so a body can be created with its draw target and draw depth.
Added: Added "PhysicsConstants.MaxBounceIterations" and "PhysicsConstants.MinMaximumLinearSpeed".
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 "WorldProfile.bounceImpulses", also shown in the 2D Physics Profiler module.
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.
Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
QNXAPI 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 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 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
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 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
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
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
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
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 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.
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).
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-10Remove 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