Added nested formats to the Smart Strings time formatter, so a nested list format can choose the separators between time units. The time formatter also accepts a DateTime or DateTimeOffset without format text.
UI ToolkitImprovement
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Importing a localization table collection now warns when two of its keys hold the same ID, or when it has no shared table data.
Improved data source context caching.
UI ToolkitImprovement
Improved dragging the label of angle fields in the UI Toolkit Authoring inspector, which now moves one degree per pixel in every unit and keeps fractional values.
UI ToolkitImprovement
Improved Editor performance when importing style sheets, which no longer make UI Builder search the whole project for UXML files on every import.
UI ToolkitImprovement
Improved event dispatch performance when no events are queued and when callbacks are registered or unregistered during event dispatch.
UI ToolkitImprovement
Improved Smart Strings: plural formatting now works for languages without plural forms and for a count of two in French, conditional formats read numbers the same way in every culture, and dictionary lookups follow the case-sensitivity setting.
UI ToolkitImprovement
Improved style sheet import diagnostics: an @import placed after style rules now produces a warning explaining that its position does not affect selector priority.
UI ToolkitImprovement
Improved style update performance for elements with transitions when an ancestor's class or pseudo-state changes without affecting their matched style rules.
UI ToolkitImprovement
Improved the performance of removing elements from a UI Toolkit hierarchy, and of binding large inspectors and editor UIs.
UI ToolkitImprovement
Reduced the amount of memory each VisualElement uses.
UI ToolkitImprovement
Add Depth Pyramid for GTAO in URP
URPImprovement
Reduced Editor startup time on Windows by removing an unnecessary wait for a background device-identifier lookup.
WindowsImprovement
Windows IL2CPP builds now use .NET 10 base class libraries.
WindowsImprovement
Graphics: Reduced CPU main thread time on URP XR Quad Views by having the inner view reuse the outer view's cached volume stack instead of re-evaluating the volume framework per stacked camera per frame.
XRImprovement
Graphics: Reduced GPU frame time on Quad Views by reprojecting the outer pass's motion vectors into the inner pass instead of rendering its own motion vector pass.
XRImprovement
Improved GPU performance when QuadViews are enabled in Forward/Forward+ (and when not using SpaceWarp) via reducing the amount of redundant geometry rendering in the focus-inner region during the low-resolution periphery pass.
XRImprovement
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 BuildHistory.TryGetParentBuild and BuildHistory.GetChildBuilds to find the build a build ran inside and the builds it ran, recorded in the new BuildReportSummary.ParentBuildSessionGUID.
Changed: BuildPipeline.BuildContentDirectory now throws an ArgumentException if the requested compression type is not supported on the target platform.
Build PipelineAPI change
Added: Added HierarchyViewColumnDescriptor.MinWidth to set the minimum width of a custom Hierarchy column.
Added: Added SourceTemplateAttribute.Target and the SourceTemplateTargetExpression enum to the built-in JetBrains.Annotations, so source templates can use Target = SourceTemplateTargetExpression.Outer.
Linked bug report
UUM-84741: The "Target" Source Template is missing when using the Unity JetBrains.Annotations library subset
Reproduction steps: 1. Open the attached “TargetExpressionBug” project 2. Open the “Assets/Scenes/SampleScene” scene 3. Observe the Console logs Expected Result: No errors are thrown in the Console Actual Result: “The type or namespace name 'Target' could not be found” error is thrown in the Console Reproducible with: 2021.3.45f1, 2022.3.50f1, 6000.0.24f1 Reproducible on: Windows 11 Pro Not re…
Retrieved 2026-11-12Added: Expose BuildProfileGraphicsSettings and BuildProfileQualitySettings as public build profile components.
EditorAPI change
Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.
EmbeddedLinuxAPI change
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
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
Added: Added iPhone 18 Pro, iPhone 18 Pro Max and iPhone Duo device generation enums and screen cutouts.
iOSAPI 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 "PhysicsDrawOverride" in "Unity.U2D.Physics.Editor", with "enabled", "settings", "defaultSettings", "changed", the "PhysicsDrawOverride.Settings" struct and the "PhysicsDrawOverride.OverrideOptions" flags, so editor tooling can read and write the Editor draw override.
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: 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: 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 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 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".
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
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