Updated the Universal 2D project template to include 2D Physics Core settings.
2DChange
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Adaptive Performance settings assets are now generated in Assets/Settings/AdaptivePerformance, and existing assets in Assets/Adaptive Performance are moved there automatically.
Adaptive PerformanceChange
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 loading animation clips saved before Unity 1.6; open and re-save such clips in an older version of Unity to keep their curves.
AnimationBreaking
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
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
Removed the Low option from the Managed Stripping Level Player setting. Projects that use Low are upgraded to Minimal when opened, which might increase build size.
Code StrippingBreaking
Update the native Selection API to use ObjectPtr instead of ObjectRef.
CoreChange
Environment.Exit() now throws a PlatformNotSupportedException on the CoreCLR scripting backend. Use Application.Quit() instead.
CoreCLRChange
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
Fast Enter Play Mode is now the default for projects created with the "-createProject" editor command line argument, from script code and for projects without a ProjectSettings/EditorSettings.asset file. Affected projects will now default to the "Reload Scene Only" option when entering and exiting playmode in the editor rather than "Reload Domain and Scene". Existing projects are unaffected. For more information see the online documentation:
EditorChange
[Configuring how Unity enters Play mode](https://docs.unity3d.com/7000.0/Documentation/Manual/configurable-enter-play-mode.html)
ChangesChange
[Enter Play mode without domain reload](https://docs.unity3d.com/7000.0/Documentation/Manual/domain-reloading.html)
ChangesChange
[Domain and scene reload execution order reference](https://docs.unity3d.com/7000.0/Documentation/Manual/configurable-enter-play-mode-details.html).
ChangesChange
Moved Transparency Sort settings out of the Built-In tab in Graphics settings.
EditorChange
Removed macOS x64 Editor and Player support.
EditorBreakingmacOS
Removed support for Mono-based Editor
EditorBreaking
Shortcut actions and global input handlers now run outside of OnGUI, so Event.current is null inside them; use ShortcutArguments.sourceEvent to read the triggering event.
The macOS character palette shortcut now only opens the palette while a text field is being edited.
EditorChangemacOS
Diagnostic Data Collection is now enabled by default for every build profile, including in upgraded projects, unless a build profile explicitly disables it.
Engine DiagnosticsChange
Diagnostic data is no longer collected in the Editor when the active build profile targets a platform that doesn't support Diagnostics.
Engine DiagnosticsChange
Editor crash and exception reporting to Diagnostics now follows the Diagnostic Data Collection setting of the active build profile.
Engine DiagnosticsChange
Removed the Diagnostics page from Project Settings > Services. Diagnostic Data Collection is now configured for each build profile in the Build Profiles window, and Project Settings > Services describes the diagnostic data that Unity collects.
Engine DiagnosticsBreaking
The Diagnostic Data Collection setting in the Build Profiles window now offers Enabled and Disabled, and disabling it no longer asks for confirmation.
Engine DiagnosticsChange
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
EntityManager.CopyEntitiesFrom no longer makes structural changes in the source world.
EntitiesChange
GameObjects now have entities with chunk storage in the active World, so entity queries match them like any other entity.
EntitiesChange
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 Entities package dependency on the Audio module. Projects that use Entities can now remove the Audio module.
Entities
Renamed the blob asset analyzer diagnostics EA0001, EA0002, EA0003 and EA0009 to UAC0040, UAC0041, UAC0042 and UAC0043, which now also check code in the Entities engine module.
Entities
The Unity.Entities runtime now ships in the engine as UnityEngine.EntitiesModule. Its public types are forwarded from the Unity.Entities package assembly, so existing code keeps compiling.
EntitiesChange
UnityObjectRef<T> now has a public EntityId property and a FromEntityId factory method.
EntitiesChange
When a world has several managed systems of the same type, GetExistingSystemManaged and GetOrCreateSystemManaged now return the most recently created one, matching ISystem lookups.
EntitiesChange
Bake Reflection Probes no longer bakes Custom reflection probes, because it replaced their cubemap with a generated one. To bake a Custom probe, use the Bake button in its Inspector.
Linked bug report
UUM-141083: An "Unknown reflection probe mode: 1" error is thrown when baking Realtime Reflection Probes
Steps to reproduce: Create and open a new URP 3D project Create a Reflection Probe in the Hierarchy Change its type to "Realtime" in the Inspector Open Window -> Rendering -> Lighting Next to "Generate Lighting" press the dropdown and select "Bake Reflection Probes" Observe the Console Actual results: An "Unknown reflection probe mode: 1 UnityEditor.GenericMenu:CatchMenu (object,string[],int)"…
Retrieved 2026-11-11Lightmapping.BakeReflectionProbe now returns false and logs an error for Realtime reflection probes instead of writing a cubemap.
Linked bug report
UUM-141083: An "Unknown reflection probe mode: 1" error is thrown when baking Realtime Reflection Probes
Steps to reproduce: Create and open a new URP 3D project Create a Reflection Probe in the Hierarchy Change its type to "Realtime" in the Inspector Open Window -> Rendering -> Lighting Next to "Generate Lighting" press the dropdown and select "Bake Reflection Probes" Observe the Console Actual results: An "Unknown reflection probe mode: 1 UnityEditor.GenericMenu:CatchMenu (object,string[],int)"…
Retrieved 2026-11-11Realtime Reflection Probes no longer use a baked fallback cubemap when Realtime Reflection Probes is disabled in Quality settings, including cubemaps baked before a probe was switched to Realtime.
GIChange
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 obsolete Built-in Render Pipeline components and shaders from UI, and marked them not supported in the inspector
GraphicsBreaking
Sprite Renderer no longer applies GPU blend shapes when Mesh Deformation is set to CPU in Player Settings.
GraphicsChange
Removed a warning displayed at build time in specific XR setup that is breaking build determinism for Content Directory builds.
HDRPChangeXR
On an unfolded iPhone Duo, Display.main was the outer panel instead of the panel the game renders on, so rendering to Display 2 replaced the game and Screen.fullScreen returned false. (PLAT-22932)
iOSChange
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).
Changed Package Manager to use the production environment when the Editor's cloud environment is set to a value other than production or staging.
Package ManagerChange
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-10A contact cancelled by a pre-contact callback is now updated every simulation step, so the callback is called every step while the shapes stay in contact.
Changed the default "PhysicsShapeDefinition" to enable "contactEvents" and "triggerEvents", and the default "PhysicsChainDefinition" to enable "triggerEvents", so a shape only needs "isTrigger" enabled to detect other shapes.
Contact and hinge joint solving were restructured, so simulation results can differ slightly from previous versions.
Polygons created from vertices now keep vertices that are much closer together before welding them, and "PhysicsWorld.minPolygonEdgeLength" now reports this smaller distance.
Remove 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
Removed forced managed GC after a (single-mode) scene load in the CoreCLR Player.
ScriptingBreaking
Removed forced managed GC after a scene load in the CoreCLR Editor.
ScriptingBreaking
UNITY_64 preprocessor symbol no longer gets defined when building for any platform.
ScriptingChange
DEVELOPMENT_BUILD preprocessor symbol no longer gets defined when building for any platform. Preprocessor symbols DEBUG, ENABLE_ASSERTIONS and ENABLE_PROFILER now only get defined in appropriate managed code variants (debug, checked and instrumented, respectively). BuildOptions.ForceEnableAssertions, CodeAnalysisFlags.DevelopmentBuild, ScriptCompilationOptions.DevelopmentBuild, ScriptCompilationOptions.Assertions and AssemblyBuilderFlags.DevelopmentBuild have been removed: script compilation is now only affected by the managed code variant.
ScriptingBreaking
Changed text serialized files so they begin with a %UNITY format version directive, which makes an earlier version of Unity report an explicit error when opening a file saved in this version instead of loading it with missing data.
SerializationChange
Text serialized files such as scenes and prefabs no longer start with a %UNITY 7.0 line, so Unity 6 can open them again, and files saved with that line still load.
SerializationChange
Reflected function fallback keys now use the fully qualified signature (this will not impact correct usage of the ProviderKey hint).
ShadergraphChange
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
UnityEditor.Rendering.CoreBuildData.developmentBuild is now an error to use instead of a warning. It was already obsolete since Unity 6.6 and always returned false. Use UnityEditor.Rendering.CoreBuildData.useDiagnosticChecks instead.
SRP CoreChange
Fixed Is.Not.AllocatingGCMemory() under-reporting allocations when another allocation constraint runs inside the measured delegate.
Test FrameworkChange
Updated FreeType to version 2.15.0, which adds support for mirrored Apple Color Emoji glyphs on macOS and slightly changes how text renders in the Hinted Smooth and OS Default font rendering modes.
TextChangemacOS
The URP sample template no longer includes a copy of the TextMesh Pro essential resources and uses the built-in resources from the uGUI package instead.
TextMeshProChange
Built-in USS filter functions with missing or wrong-typed arguments now use the filter's default values and log a warning instead of an error.
Changed Constant Physical Size panels to account for the Game view's Low Resolution Aspect Ratios setting when resolving scale.
UI ToolkitChange
Changed theme style sheets to rank above Unity's built-in styles regardless of selector specificity; the previous behavior can be restored with the Legacy Theme Priority setting in Project Settings > UI Toolkit.
UI ToolkitChange
Changed touch dragging of ScrollView content on world-space panels so the content follows the finger pixel for pixel, regardless of the Pixels Per Unit setting.
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-09Changed z-index transitions between auto and an integer to switch at the midpoint of the transition instead of interpolating from 0, to match CSS.
UI ToolkitChange
Fixed grid line placement and -unity-slice properties not recording or playing back in UI Animation Clips.
UI ToolkitChange
Importing localization shared table data that has two entries using the same key now renames the duplicate and logs a warning.