Obsoleted: Marked HierarchySearchProvider as obsolete with an error. To find entities by component, use the t: filter in the Hierarchy window.
EntitiesBreaking
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
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
Removed the deprecated Entities Hierarchy window. Use the Hierarchy window to view and search entities instead.
EntitiesBreaking
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
Deprecated: Deprecated the Write Groups API
EntitiesBreaking
Deprecated: Deprecated the HierarchySearchProvider class. The standalone Entities Hierarchy window has been replaced by the integrated Editor Hierarchy window.
EntitiesBreaking
Obsoleted: Marked HierarchySearchProvider as obsolete with an error. To find entities by component, use the t: filter in the Hierarchy window.
EntitiesBreaking
Obsoleted: Obsoleted Unity.Assertions.Assert in favour of UnityEngine.Assertions.Assert, which it forwarded to. The API Updater converts existing uses.
EntitiesBreaking
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
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: Added LicensingUtility.HasPro, HasEduLicense, IsPersonal, and GetAuthToken, which replace the deprecated license helpers on UnityEditorInternal.InternalEditorUtility.
LicenseBreaking
Deprecated: Deprecated the license helper methods on UnityEditorInternal.InternalEditorUtility.
LicenseBreaking
Removed: Removed UnityEditorInternal.InternalEditorUtility.GetLicenseFlags, which already produced a compile error when used.
LicenseBreaking
Deprecated: Deprecated "PhysicsWorld.elementDepth" and "PhysicsWorld.SetElementDepth3D()" in favor of "PhysicsWorld.drawDepth" and "PhysicsWorld.SetDrawDepth3D()". The old names upgrade automatically.
Physics 2DBreakingUUM-155044
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
Deprecated: Deprecated UnityEditor.WebGLLinkerTarget and WebGLWasmArithmeticExceptions enums.
WebBreaking
Obsoleted: Marked PlayerSettings.WebGL.memorySize as obsolete.
WebBreakingWebGL
Removed support for Mono-based Android players
AndroidBreaking
Removed support for x64 and Universal Simulator architectures.
Apple TVBreaking
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
Removed experimental label from CoreCLR
CoreCLRBreaking
Removed macOS x64 Editor and Player support.
EditorBreakingmacOS
Removed support for Mono-based Editor
EditorBreaking
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
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
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
Removed support for x64 and Universal Simulator architectures.
iOSBreaking
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
Remove deprecated BIRP support for PhysicsCore2D renderer.
Physics 2DBreaking
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
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

Added: Added Application category which returns application category which settable in Player Settings.
AndroidAPI change
Added: Added BuildHistory.TryGetParentBuild and BuildHistory.GetChildBuilds to find the build a build ran inside and the builds it ran, recorded in the new BuildReportSummary.ParentBuildSessionGUID. (UUM-153441) First seen in 7000.0.0a3.
Build PipelineAPI changeUUM-153441
Added: Added API to get the event that triggered the shortcut in the ShortcutArguments.
EditorAPI changeUUM-153126
Added: Added HierarchyViewColumnDescriptor.MinWidth to set the minimum width of a custom Hierarchy column.
EditorAPI changeUUM-155402
Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
EmbeddedLinuxAPI change
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 DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
QNXAPI change
Added: Enabled Upscaling Framework by default.
SRP CoreAPI change
Added: Added ScrollView.touchScrollDirection to make the content move opposite to the pointer when dragged with touch or a tracked device.
UI ToolkitAPI changeUUM-139596
Added: Enabled Upscaling Framework by default.
URPAPI change
Added: Added Application category which returns application category which settable in Player Settings.
AndroidAPI change
Added: Added BuildAnalysisUtility.OpenWindow, which opens the Build Analysis window with a specific build selected.
Build PipelineAPI change
Added: Added API to get the event that triggered the shortcut in the ShortcutArguments.
EditorAPI changeUUM-153126
Added: Added HierarchyViewColumnDescriptor.MinWidth to set the minimum width of a custom Hierarchy column.
EditorAPI changeUUM-155402
Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
EmbeddedLinuxAPI change
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
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: 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
Added: Added "currentSpringForce" to "PhysicsDistanceJoint", "PhysicsSliderJoint" and "PhysicsWheelJoint", and "currentSpringTorque" to "PhysicsHingeJoint".
Physics 2DAPI changeUUM-154721
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.
Physics 2DAPI changeUUM-153476
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.
Physics 2DAPI changeUUM-153476
Added: Added "PhysicsBody.drawDepth" and "PhysicsBody.SetDrawDepth3D()" to set the depth a body is drawn at when it has no transform object.
Physics 2DAPI changeUUM-155044
Added: Added "PhysicsBodyDefinition.drawTarget" and "PhysicsBodyDefinition.drawDepth" so a body can be created with its draw target and draw depth.
Physics 2DAPI changeUUM-155044
Added: Added "PhysicsConstants.MaxBounceIterations" and "PhysicsConstants.MinMaximumLinearSpeed".
Physics 2DAPI changeUUM-154721
Added: Added "PhysicsWorld.bounceIterations", "PhysicsWorld.bouncePropagation" and the matching "PhysicsWorldDefinition" properties, to control how bounces are resolved.
Physics 2DAPI changeUUM-154721
Added: Added "WorldProfile.bounceImpulses", also shown in the 2D Physics Profiler module.
Physics 2DAPI changeUUM-154721
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
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
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.
UI ToolkitAPI changeUUM-139596
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

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.