Release Notes Search

Improved how text-serialized files with invalid object headers are loaded: Unity now reports an error instead of reading the object's fileID from part of the header, or skipping the object without an error.

Improved loading of serialized data whose layout does not match the script it belongs to: the player now logs a serialization error instead of crashing.

The editor console and shader inspector now emit warnings when invalid KEYWORD_TYPE_FLAG keywords are detected.

Improved test result reporting speed for large test assemblies, where looking up each test's source file and line no longer slows the run down as the number of tests grows.

Improved test result reporting speed for runs with many tests, which no longer slows down as the number of tests grows.

Improved the speed of edit mode test runs while the Editor is not the active application, which previously slowed to 10 Editor updates per second.

Improved the speed of edit mode test runs while the Test Runner window is open, which no longer repaints and recounts all results for every finished test.

Prebuild setup, post-build cleanup and player build steps are now reported as timing spans during automated test runs.

Timing spans reported during automated test runs now name their parent test or span explicitly.

2D textures dropped onto uGUI Canvas objects in the hierarchy now create or update a RawImage, or a RawImage animation for multiple textures.

Added the DISABLE_UGUI_UITK_SUPPORT scripting define symbol, which excludes the uGUI integration with UI Toolkit so that player builds can strip the UI Toolkit module when it is only used in the Editor.

Sprites dropped onto uGUI Canvas objects in the hierarchy now create or update an Image, or an Image animation for multiple sprites.

Added a one-time scan that lists themes affected by the theme priority change, with a report file written to Logs/ and an on-demand scan button in Project Settings > UI Toolkit.

Added a warning when a theme style sheet is imported by a regular style sheet, since the theme's priority does not apply in that case.

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.

Added Prepare Panel Renderers and Update Panel Renderers charts to the UI Toolkit Profiler module, which show the time spent processing Panel Renderer components, including UI reload callbacks.

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.

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.

Improved Editor performance when importing style sheets, which no longer make UI Builder search the whole project for UXML files on every import.

Improved event dispatch performance when no events are queued and when callbacks are registered or unregistered during event dispatch.

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.

Improved style resolution performance when many elements share the same cached styles.

Improved style sheet import diagnostics: an @import placed after style rules now produces a warning explaining that its position does not affect selector priority.

Improved style update performance for elements with transitions when an ancestor's class or pseudo-state changes without affecting their matched style rules.

Improved the performance of cloning UXML documents that instantiate templates.

Improved the performance of pointer event dispatch, especially when the pointer moves between deeply nested elements.

Improved the performance of removing elements from a UI Toolkit hierarchy, and of binding large inspectors and editor UIs.

Improved the performance of scheduling and unscheduling actions with VisualElement.schedule in panels that have many scheduled items.

Improved the performance of visual element change notifications in UI Toolkit by only notifying the internal updaters that handle each type of change.

Reduced the amount of memory each VisualElement uses.

Reduced the GPU memory used to render elements with the filter style property.

Reduced the memory used by each component added to a VisualElement, and by component types that are registered but never added.

Removed the per-restyle managed allocations for elements whose UXML inline style declares custom properties (USS variables).

UI Builder no longer searches the whole project after every UXML or USS change when no UI Builder window is open.

Add Depth Pyramid for GTAO in URP

Reduced memory use for renderers that have no additional lights or don't use the reflection probe atlas, and main thread time for cameras that see no reflection probe.

The Forward+ and Deferred+ rendering paths no longer process lights and reflection probes in screen areas that only their part beyond the far plane, or in front of an orthographic camera's near plane, reaches.

Improved Web Build Size by disabling Input System's Precompiled Layouts for Web Builds.

Reduced Editor startup time on Windows by removing an unnecessary wait for a background device-identifier lookup.

Windows IL2CPP builds now use .NET 10 base class libraries.

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.

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.

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.

Changed: Moved EntityIdTileUtility from the UnityEditor.Tilemaps.Experimental namespace to UnityEditor.Tilemaps.

Added: Added Application category which returns application category which settable in Player Settings.

Added: Added AnimatableFloatChannels, AnimatableIntChannels and AnimatableObjectChannels.

Added: Added BuildAnalysisUtility.OpenWindow, which opens the Build Analysis window with a specific build selected.

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.

Added: Added BuildSummary.projectGuid and BuildSummary.projectName, and BuildReportSummary.ProjectGUID and BuildReportSummary.ProjectName, which record the project that made a build.

Changed: BuildPipeline.BuildContentDirectory now throws an ArgumentException if the requested compression type is not supported on the target platform.

Deprecated: Deprecated ManagedStrippingLevel.Low. Passing it to PlayerSettings.SetManagedStrippingLevel now throws a NotSupportedException; use ManagedStrippingLevel.Minimal instead.

Added: Added ability to reflect information on structs, as one can with functions, from .hlsl assets.

Added: Added AnalysisResult.Skipped, which Project Auditor reports for a module that could not run in the current context.

Added: Added API to get the event that triggered the shortcut in the ShortcutArguments.

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.

Added: Added the BuildProfilePlayerSettings component, so that you can create, get, and remove a build profile's own player settings with BuildProfile.CreateComponent, GetComponent, and RemoveComponent.

Added: Expose BuildProfileGraphicsSettings and BuildProfileQualitySettings as public build profile components.

Added: Project Auditor: Added Descriptor.HasAnyAreas and ReportItem.HasAnyAreas to filter issues by area, and made SerializableEnumExtensions public so IssueCategory arrays can be assigned to AnalysisParams.Categories.

Obsoleted: Output an error instead of a warning when ARCoreUpdate and ARCoreEnabled APIs are used.

Added: Added DisplayInfo.RegisterLayoutChangedCallback and DisplayInfo.UnregisterLayoutChangedCallback, which notify the application when a display is connected, disconnected or reconfigured.

Changed: EngineDiagnosticsSettings.enabled now reads and writes the Diagnostic Data Collection setting of the active build profile, or of the active platform profile if no build profile is active, and doesn't change other build profiles. To disable Diagnostic Data Collection for all users and CI, set it to Disabled in a build profile asset, commit the asset, and build with that profile by using -activeBuildProfile or BuildPipeline.BuildPlayer with BuildPlayerWithProfileOptions.

Added: Added an implicit conversion from EntityId to Entity.

Added: Added GlobalEntityManager, which reads and changes an entity in whichever world owns it, and instantiates an entity from any world into a given world.

Deprecated: Deprecated the Write Groups API

Deprecated: Deprecated the HierarchySearchProvider class. The standalone Entities Hierarchy window has been replaced by the integrated Editor Hierarchy window.

Obsoleted: Marked HierarchySearchProvider as obsolete with an error. To find entities by component, use the t: filter in the Hierarchy window.

Obsoleted: Obsoleted Unity.Assertions.Assert in favour of UnityEngine.Assertions.Assert, which it forwarded to. The API Updater converts existing uses.

Removed: Removed the Entities Journaling window and the EntitiesJournaling API, deprecated in Unity 6.5; use the IDebugOnAdded and IDebugOnRemoved component lifecycle callbacks instead.

Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).

Deprecated: Deprecated ProbeVolumeBakingSet.sceneGUIDs (use scenesInBakingSet instead), and the string overloads of TryAddScene, RemoveScene, SetSceneBaking (use the GUID overloads instead).

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).

Obsoleted: LightingSettings.Lightmapper.ProgressiveCPU now produces a compiler error; use LightingSettings.Lightmapper.ProgressiveGPU or LightingSettings.Lightmapper.UnityComputeGPU instead.

Added: Added StateMachine.OnDefineSubgraphStateOptions to define the options of subgraph states that reference a state machine.

Added: Added Graphics.disableDepthAndStencilBuffers, a read-only property that returns whether Disable Depth and Stencil Buffers is enabled in Player Settings.

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.

Added: Added UnityEngine.Rendering.PrecompiledGraphicsState.GetStats, which returns statistics of the precompiled graphics states usage for the current graphics device (if supported).

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.

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.

Deprecated: Deprecated Unsupported.useScriptableRenderPipeline because the Built-In Render Pipeline is obsolete

Added: Enabled Upscaling Framework by default.

Added: Added iPhone 18 Pro, iPhone 18 Pro Max and iPhone Duo device generation enums and screen cutouts.

Changed: PBXProject build property setters (SetBuildProperty, AddBuildProperty, UpdateBuildProperty and their ForConfig variants) now throw ArgumentNullException when given a null value.

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.

Changed: Trampoline DisplayConnection is now created with initWithScene: and exposes a scene property; DisplayManager is keyed and subscripted by UIWindowScene instead of UIScreen. (PLAT-22932)

Added: Added MemoryLabel.Create

Added: Added Unity.Mathematics math.select overloads for bool, bool2, bool3, and bool4 values, with either a single bool or a per-component bool vector as the selection mask.

Added: Added LicensingUtility.HasPro, HasEduLicense, IsPersonal, and GetAuthToken, which replace the deprecated license helpers on UnityEditorInternal.InternalEditorUtility.

Added: EntitlementGroupInfo.TryGetExpirationUtc (not yet used, except in tests) for reading an entitlement group's expiry as a DateTime.

Changed: Moved the licensing API from the UnityEditor.Experimental.Licensing namespace to UnityEditor.Licensing. Existing code is updated automatically when the project is imported.

Deprecated: Deprecated the license helper methods on UnityEditorInternal.InternalEditorUtility.

Removed: Removed UnityEditorInternal.InternalEditorUtility.GetLicenseFlags, which already produced a compile error when used.

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.