Release Notes Search

iOS builds now use .NET 10 base class libraries.

Make AppDelegate and SceneDelegate methods in UnityPlayer public

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

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

Reduced JIT compile overhead by skipping JIT phase timing when runtime statistics are disabled.

Analytics for .unityPackage signature at export time, from UI, API and CLI

Improves keyboard navigation in the package manager details and toolbar

Improved performance and memory use when many physics objects share the same callback target.

Improved the accuracy of bouncing, which is now resolved after the rest of the contact solving each simulation step.

Improved the performance of contact creation and shape queries.

Improved the PhysicsCore2D Profiler to show timing information in a consistent hierarchy which indicates not only the times taken but also where in relation to other timings they occur.

- Improved module pinning UX in the profiler window. It is now possible to pin modules by hovering on a module chart header and clicking the pin icon, or directly from the Profiler Modules dropdown.

Added a draggable divider below the pinned modules. When the pinned modules don't fit in the pinned area, the area scrolls and you can drag the divider to resize it.

Improved native memory attribution so several kernel, plugin and file system allocations are reported against a named root instead of Unrooted in the Memory Profiler.

Reduced GC.Alloc hook overhead when profiler is disabled or there are no active ProfilerRecorders for GC.Alloc metric.

Replaced the Scene View orientation gizmo with a lighter UI Toolkit implementation, reducing its per-repaint cost and giving it a new flat-icon style.

The "IL2CPP Stacktrace Information" setting has been renamed to "Managed Stack Trace Information" and now affects the CoreCLR scripting backend too.

The "Managed Stack Trace Information" setting now affects stack traces printed from Burst code.

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.

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.

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

Reduced the amount of memory each VisualElement uses.

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

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.

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

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

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

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.

Added: Added MemoryLabel.Create

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.

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.SetBatchDefinition" to set the same definition on a batch of shapes.

Added: Added "PhysicsShape.SetCallbackTarget", "PhysicsBody.SetCallbackTarget" and "PhysicsJoint.SetCallbackTarget" to set the same callback target on a batch of objects.

Added: Added "PhysicsShape.SetPhysicsGroup" to set the same physics group on a batch of shapes.

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.

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.