Fixed the background gradient in the UI Toolkit Inspector defaulting to white-to-white instead of the black-to-white default used by UI Builder.
Release Notes Search
Search changes, fixes, and known issues across Unity releases.
Fixed the content of a ListView or TreeView with horizontal scrolling moving horizontally when scrolling vertically.
Linked bug report
UUM-147817: UI Toolkit Horizontal scroller visible content moves left based on the vertical scroller position
Steps to reproduce: Open the "UiToolkitUXIssue.zip" project Open the "SampleScene" Open the 'Window -> UI Toolkit -> Debugger' window Enable 'Pick Element' in the UI Toolkit Debugger Select the top left square in the Game view Select the second-to-last item in the UI Toolkit Debugger (because of another bug) Scroll to the top and observe the horizontal scroller Actual results: The scroller is …
Retrieved 2026-11-10Fixed the cursor not updating immediately when a VisualElement's style.cursor was reset to its default value while the pointer was over the element.
Fixed the Dynamic Atlas Viewer showing no atlas after the UI Toolkit Debugger window was recreated, such as when maximizing and restoring a docked window or toggling UI Toolkit Live Reload on the debugger.
Linked bug report
UUM-150663: UI Toolkit Debugger's Dynamic Atlas Viewer window does not display an atlas after it was Maximized
Steps to reproduce: Create a new project Open the UI Toolkit Debugger window (Window -> UI Toolkit -> Debugger) Select the Inspector window as the debugger's target Press the Texture Atlas Viewer button to open its window and dock it Switch the Debugger's target to SceneView (Or any other window that has an Atlas) Observe that the Atlas is displayed as expected Switch the Debugger's target bac…
Retrieved 2026-11-10Fixed the Dynamic Atlas Viewer window failing to reload and logging a serialization error when toggling UI Toolkit Live Reload.
Linked bug report
UUM-150660: UI Toolkit Debugger's Dynamic Atlas Viewer window throws a window serialization error if Live Reload is enabled
Steps to reproduce: Create a new project Open the UI Toolkit Debugger window (Window -> UI Toolkit -> Debugger) Select any window as the debugger's target Press the Texture Atlas Viewer button to open its window Right-click on the Texture Atlas Viewer window handle Select the UI Toolkit Live Reload option Observe the Console window Actual results: A window serialisation error is thrown every t…
Retrieved 2026-11-10Fixed the Editor and Players hanging when a USS transition-timing-function declaration uses a value that is not a keyword, such as 5px.
Linked bug report
UUM-155159: Editor and built players hang indefinitely when a USS declaration gives transition-timing-function a non-keyword value
Steps to reproduce: Create a new project Add the attached freeze.uss to the project Add a UI Document to the scene and add freeze.uss to its stylesheets, or add the stylesheet to any EditorWindow's rootVisualElement Let the UI resolve its styles Actual result: The Editor stops responding and never recovers, and has to be force-quit. A built Standalone player hangs the same way during its first…
Retrieved 2026-11-10Fixed the editor crashing when the UXML document being edited was assigned as a column's header or cell template in the UI Toolkit inspector.
Fixed the Editor freezing when a VisualElement was added under one of its own descendants, which now throws an ArgumentException instead.
Fixed the Enable Filter Shader Graph setting being hidden unless the Editor was in developer mode.
Fixed the first synchronous localization read returning the project locale's value instead of the language selected at startup.
Fixed the Game view toolbar's view dropdown showing no label when the Editor language is not English.
Fixed the GameObject menu offering creation items in the UI authoring stage, where the new GameObject was created in the hidden main scene and never appeared.
Fixed the gradient angle field in the UI Builder and UI Toolkit Authoring inspectors, which only accepted degrees; it now offers degrees, gradians, radians and turns, and keeps the chosen unit in the stylesheet.
Fixed the Gradient Editor clearing the redo history and adding an empty Modify Gradient undo step when it closed after an undo.
Linked bug report
UUM-153510: ShaderGraph gradient Undo/Redo action stack is incorrect when undoing multiple actions with "HDR Gradient Editor" window open
How to reproduce: Create a new project using the “Universal 3D” tempalte In the Project window, right click and select “Create → Shader Graph → URP → Lit Shader Graph” Open the created Shader Graph In the Shader Graph window, right click and select “Create Node → Input → Gradient → Gradient” In the Gradient node, click on the gradient color section In the HDR Gradient Editor window, select the…
Retrieved 2026-11-10Fixed the Inspector help button opening a missing documentation page when multiple UI Toolkit elements were selected in the Hierarchy.
Linked bug report
UUM-153256: Documentation Help icon on multi-selected Visual Element assets lead to a "Sorry... that page seems to be missing!" page
Steps to reproduce: Create a new 3D URP project In the Hierarchy, right-click > UI Toolkit > Standard Elements > Visual Element Save the new .uxml file Have two Visual Elements available Fully expand the .uxml in Hierarchy Multi-select two Visual Elements In the Inspector, observe the "2 Visual Element Selections" is shown Click on the help icon to open Reference Actual results: “Sorry... that…
Retrieved 2026-11-10Fixed the invert and contrast filters producing colors that were too bright on translucent pixels, such as after opacity in a backdrop-filter chain or on the anti-aliased edges of filtered elements.
Fixed the Localization New entry popup staying open after its GameObject was deselected, and discarding the typed name instead of creating an entry.
Fixed the Localization package Addressables page not listing the Check Module Localization Tables analyzer.
UI ToolkitUUM-156659
Fixed the Localization package changelog and upgrade guide listing a Smart Format deprecation that the package does not contain.
Fixed the Localization package quick start guide naming a Create button that no longer exists in 2.0.
Fixed the Localization package upgrade guide missing a 2.0.0 section for the upgrade wizard.
Fixed the Localization reference field dropdown caret drawing as a text character instead of the standard Editor arrow icon.
Fixed the Localization Tables and Scene Controls windows ignoring built-in localization in projects that use it.
Fixed the Localization upgrade not reporting Smart entries that escape braces with {{ and }}, which the built-in Smart Strings do not read.
Fixed the macOS character palette and IME candidate window appearing at the caret position of a previously edited text field.
Fixed the macOS character palette opening at the wrong position, or not opening, when a UI Toolkit text field has focus.
Fixed the metadata icon rendering blurry in the Resource Tables window.
Fixed the min and max values of a minmax() grid track being hidden behind their unit dropdowns in the UI Builder Inspector.
Fixed the New Collection button staying disabled in the Resource Tables window after adding the first locale.
Fixed the Panel Renderer Inspector not showing World-Space values after Undo.
Linked bug report
UUM-154985: World Space Panel Renderer Inspector does not refresh when undoing a change
Steps to reproduce: Create a new Unity project using the Universal 3D template Create a new Panel Settings asset (Assets > Create > UI Toolkit > Panel Settings) Select the "Assets/New Panel Settings.asset" asset in the Project window Change Render Mode to "World Space" in the Inspector window Create a new Panel Renderer GameObject in the Hierarchy window (Right-click > UI Toolkit > Panel Rende…
Retrieved 2026-11-10Fixed the Paste option staying enabled for read-only UXML assets in the UI Builder window.
Fixed the render statistics in the UI Toolkit Debugger panel details always displaying zero.
Fixed the Scene view stealing focus from the previously focused window when exiting in-context UI editing.
Fixed the Select GameObject window silently ignoring Prefab picks in a second Inspector after swapping between Prefabs with different components.
Linked bug report
UUM-154149: "Select GameObject" window silently stops applying prefab selections when swapping between prefabs with different components in specific Inspectors
How to reproduce: Open the attached "IN-153731_repro.zip" project Open the “Main” scene Select the "GameObject 1" instance in the Hierarchy tab In the right-side Inspector tab, click the circle icon next to the Prefab field to open the Select GameObject window In the “Select GameObject” window, click "GameObject 2", then "GameObject 1", then "GameObject 2" (three clicks in total) Observe the p…
Retrieved 2026-11-10Fixed the selected collection's name becoming unreadable when you hover over it in the Resource Tables window in the Light theme.
Fixed the Slider tracker border, and other elements using UsageHints.DynamicColor, keeping its old color when the color changed while the element was hidden.
Fixed the Smart Strings parser throwing an IndexOutOfRangeException, instead of reporting a parsing error, when a format string ends inside formatter options.
Fixed the Smart Strings substr formatter ignoring its out-of-range behavior when the start index and length were very large, or when a negative start index or length went past the ends of the string.
Fixed the Smart Strings Time formatter showing the wrong duration for negative TimeSpan values, and throwing an overflow error for TimeSpan.MaxValue and TimeSpan.MinValue.
Fixed the startup locale ignoring the region and script reported by the device, so a device set to Traditional Chinese no longer starts in Simplified Chinese.
UI ToolkitFix
Fixed the stylesheets window not rendering style rules when an invalid rule is present.
Fixed the tab view wrongfully de-attaching.
Fixed the UI Builder Background Size Height field staying disabled after changing or undoing the Scale Mode.
Fixed the UI Builder data source path picker listing paths as compatible through a converter that takes a base type, such as System.Object.
Fixed the UI Builder Hierarchy and UXML Preview showing "<unsaved file>.uxml" instead of the preview document name when a style sheet is open in StyleSheet Editing Mode.
Fixed the UI Builder Inspector's Value field staying single-line when a TextField has Multiline enabled.
Fixed the UI Builder Set Variable list on a selector not showing variables declared in another USS file on the same UXML.
Fixed the UI Preview overlay showing "Preview not available" for elements with an opacity of 0, instead of a transparent preview.
Fixed the UI Preview Scene View overlay staying visible and empty after its document was opened for editing in the UI Viewport.
Fixed the UI Toolkit Debugger hierarchy list flickering after Inspect Element on a window whose hierarchy keeps changing, such as the Entities Systems window.
Fixed the UI Toolkit Debugger picking elements from a hidden UI Viewport tab instead of the Game View content under the cursor.
Fixed the UI Toolkit editing stage opening while the legacy Hierarchy was in use, which left the Hierarchy window empty or showing the wrong scene.
Fixed the UI Toolkit ExposedReference drawer applying every change to the last field it drew, so that only one of several ExposedReference fields shown at the same time could be assigned.
Fixed the UI Viewport opening its context menu when a zoom drag is released, and leaving click selection stuck afterwards.
Fixed the UnityEvent Inspector keeping the argument field after switching the function to a different variant.
Linked bug report
UUM-142971: UnityEvent Inspector retains argument field after switching the function to a different variant
Steps to reproduce: Open the "StaleArgument.zip" project Open "SampleScene" Select the "UnityEventStaleArgRepro" GameObject In the Inspector, in the function dropdown select UnityEventStaleArgRepro > SetValue (at the top of the list) Observe the float field below the dropdown Actual results: the float field is still visible Expected results{}: the float field is hidden Reproducible with versio…
Retrieved 2026-11-09Fixed the USS import error for a nested style rule quoting a selector that is not in the file.
Fixed the UXML asset preview rendering after its asset was deleted.
Linked bug report
UUM-147940: "SoftDelete" warning is thrown and Editor freezes when deleting a UXML Asset via keyboard shortcut
Steps to reproduce: 1. Open the attached Unity project “ConsoleWarnings.zip” from provided Google Drive link 2. Clear warnings and errors in the Console window once project is open 3. Select New UXML Asset in the Project window 4. Press delete with keyboard shortcut multiple times 5. Observe the Editor and Console window Actual results: “The operation "SoftDelete" cannot be executed because th…
Retrieved 2026-11-10Fixed the UXML file being marked as having unsaved changes after canceling a rename in the UI Builder Hierarchy.
Linked bug report
UUM-139551: UXML gets dirty when canceling the renaming action in UI Builder
Steps to reproduce: Create a new project Create and open a new UI Document Add a VisualElement to the Hierarchy Press F2 to rename the element Press ESC to cancel the renaming action Observe the .uxml header Actual results: The file is dirty Expected results: The file is not dirty Reproducible with versions: 2023.1.0a10, 6000.0.72f1, 6000.3.13f1, 6000.4.3f1, 6000.5.0b4, 6000.6.0a2 Tested on (O…
Retrieved 2026-11-09Fixed the UXML preview not refreshing when a variable is added to an element in the UI Builder inspector.
Fixed the variable suggestion list being cut off when setting a variable on a stop in the Gradient Editor.
Fixed the Variables section not showing the override indicator bar, on both the foldout and the variable row, in the UI Builder and the Inspector.
Fixed TreeView and ListView items sometimes staying invisible after expanding the last item or resizing the view while scrolled to the bottom.
Linked bug report
UUM-140392: VFX Template is not rendered after expanding the last Category when Category list is scrollable
Steps to reproduce: Open the attached project Open the VFX Template window Shrink the window vertically Scroll to the bottom of the Template list Expand Category 9 (If the category was already expanded after opening the window, collapse it and reopen the Template window) Actual results: After the Category is expanded, the Template is not visible (But can be selected) Expected results: Template…
Retrieved 2026-11-11Fixed TypeConversion.TryConvert storing the bit pattern of a float or double instead of its value when converting to an enum.
Fixed UI Builder adding a duplicate attribute to Attribute Overrides when editing an override on an element whose name contains a space, which made the UXML file invalid.
Linked bug report
UUM-149755: UI Builder appends a duplicate attribute in AttributeOverrides when re-editing an override on an element whose name contains a space
How to reproduce: Open the attached "IN-148895" project Open "Main.uxml" in UI Builder In the UI Builder Hierarchy, expand "Main.uxml">"TemplateContainer" and select the "Thin g" element In the UI Builder Inspector set "Title Text Size" attribute to any value and press Ctrl+S Change "Title Text Size" attribute to a different value and press Ctrl+S Observe the Console window and “Main.uxml” cod…
Retrieved 2026-11-11Fixed UI Builder failing to open a USS file when a var() fallback contained a function with an empty argument.
Fixed UI Builder keeping discarded style sheet changes after going back more than one level from a template opened in context.
Fixed UI Builder marking the UXML and USS files as unsaved when it discarded an invalid or empty rename.
Fixed UI Builder Save not writing elements added in the Hierarchy before the UI Builder window opened.
Fixed UI Toolkit content in the Game view disappearing after importing an asset.
Fixed UI Toolkit panels not receiving pointer events after a script reload in Play mode when the scene has an EventSystem.
Linked bug report
UUM-156105: UI stops receiving pointer events after an assembly reload when using InputSystemUIInputModule
How to reproduce: Open the attached “IN-155070” project Enter Play mode Interact with the UI elements in Game view In the Project window select the “RandScript“ script and reimport it Try interacting with the UI elements in Game view again Observe the UI elements Actual result: After reimporting a script you can’t interact with the UI elements Expected result: You can interact with UI Elements…
Retrieved 2026-11-11Fixed UIAnimationClip staying at its authored values instead of animating in a built player.
Fixed UIToolkitInteroperabilityBridge allocating GC memory every frame for each UI Toolkit panel.
Linked bug report
UUM-158158: UIToolkitInteroperabilityBridge.CreatePanelGameObject allocates 32 B GC every frame per UI Toolkit panel
Steps to reproduce: 1. Open the attached project "Project.zip" 2. Open the "Assets/Scenes/SampleScene.unity" Scene 3. Open the Profiler window, switch to Hierarchy view and enable Deep Profile 4. Enter Play Mode 5. Sort by GC Alloc and expand PlayerLoop > UpdateScene > Update.ScriptRunBehaviourUpdate > BehaviourUpdate > EventSystem.Update() 6. Observe the GC Alloc of UIToolkitInteroperabilityB…
Retrieved 2026-11-11Fixed undo not removing a style class from an element that has other classes.
Fixed unpacked template elements losing their inline styles in UI Builder when Unpack Instance is undone and redone.
Fixed unpacking a template instance copying its authoring ID onto the element that replaced it.
Fixed unsaved elements of a new UI Document being lost after entering and exiting Play Mode.
Fixed unsaved UXML changes being discarded in UI Builder when "Open selector in IDE" was used while the style sheet had unsaved changes.
Fixed USS files and UXML inline styles losing all of their styles when a declaration ended with an extra semicolon.
Fixed USS filter functions with more than four arguments not applying; the extra arguments are now ignored and a warning is logged.
Fixed USS variables not working inside gradient background definitions.
Fixed UXML changes no longer syncing between UI Builder windows after one of them was maximized and restored.
Fixed UXML changes saved in UI Builder not appearing in the Game view for a Panel Renderer after Play mode was entered and exited.
Linked bug report
UUM-149762: Saved UI Document changes are not reflected in the Game view when Play mode has been entered and exited
Steps to reproduce: Create a new project using 3D URP project In the Hierarchy, create a Panel Renderer Create a new UI Document and assign it to Panel Renderer Component Open the .uxml in UI Builder Add any well visible element (e.g. Button) Save and observe the element appears in Game view Enter and exit Play mode Add another element, duplicate the same or make any visible change in UI Build…
Retrieved 2026-11-10Fixed VectorUtils.Bounds returning bounds that are too small for some curved Bezier segments.
Fixed VectorUtils.FlipVerticesInBounds moving vertices outside the bounds when the bounds do not start at y = 0.
Fixed VectorUtils.MakeArc returning a quarter circle when the sweep angle is 0.
Fixed VectorUtils.MakeArc returning an empty path when the sweep angle is a full circle.
Fixed VectorUtils.SceneNodeBounds ignoring the closing curve of closed contours.
Fixed VectorUtils.SegmentsLength measuring the closing curve of a closed path as a straight line.
Fixed world-space picking selecting the last child of a curved element when another child had its curvature set as an inline style.
Fixed world-space UI Toolkit panels not responding to XR input in players when the application window loses focus.
Fixed z-index animated through an AnimationClip applying an incorrect value, which moved the element above its siblings.
Fixed SharedTableData.AddKey, ResourceTable.AddStringEntry, and DistributedUIDGenerator.MachineId rejecting or altering their input without reporting it.
Improved grid inspector layout in UI Toolkit inspector.
Improved performance of hash code generation in GetTransitionHashCode
Improved performance of Smart Strings plural and choose formatters.
Improved the performance of updating changed elements in large panels.
Templates created from the Hierarchy with "Create Template" could not be opened in the UI Stage after being selected.
The Resource Tables window now opens on the last selected table collection, or the first one, instead of showing no collection.
UI ToolkitFix
UI Builder: Fixed the data source path completer popup in the binding window sometimes staying open after the window was moved.
Updated the inspector field in stage to match the existing renaming behavior.