Release notes for Umbraco-CMS v17.0.0
Target release date: Thursday, November 27 2025
Umbraco 17 is the new Long-Term Support (LTS) release, marking a stable foundation for many years of updates.
Extensions are now first-class citizens: older extension methods are phased out with clear, supported alternatives.
New features include support for .NET 10, load-balanced backoffice, consistent UTC date handling with time zone support.
Direct LTS-to-LTS upgrade is supported, e.g. from Umbraco 13 straight to 17 (with migrations applied automatically).
Contributors
Of the 117 bug fixes and feature additions in release/17.0.0, a total of 36 of them have been contributed by the community, by 19 unique contributors.
We're welcoming 7 brand new contributors who have made their first pull request for Umbraco-CMS. Welcome to the contributor club: Alex, DevAndersen, Ivo van der Bruggen, Janus Hasseriis, mdubbelv, Mitchel, Pantelis Sotiropoulos 🏆
All community contributors to this release

1 PR

14 PRs

1 PR

2 PRs

1 PR

4 PRs

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR

1 PR
⭐ = First pull request to Umbraco-CMS
Notable features
5

#20417 Load balancing: Load balance isolated caches to allow the backoffice to be load balanced

#20187 Models builder: Move InMemoryAuto models builder and razor runtime compilation into its own package to enable hot reload

#20021 Serverside generated preview URLs

#19915 Property Editors: New Date Time property editors

#19822 Use UTC for system dates in Umbraco
Breaking changes
22

#20399 SectionSidebarContextMenu: Delete element and methods for interaction

#20397 Load Balancing: Implement distributed background jobs

#20385 Dependencies: Update server dependencies

#20375 Property Editor Data Source

#20340 Segmentation: The Backoffice should use the enhanced endpoint to fetch segment options for documents based on GUID

#20309 Segments: Property level default segment fallback

#20305 Refactors backoffice sections with default element and context API

#20294 Deprecations: Client-side removal of v17 deprecated code

#20256 Tiptap: Relocation of external extensions/package

#20249 Unattended install: Added the ability to set the telemetry level

#20184 Dependencies: Updates to .NET 10 RC and NPoco 6.1

#20125 V17: Moves current-user related entities from 'user' to 'current-user' package

#20034 Repositories: Quote table and columns and use NPoco extensions over raw SQL

#19961 V17 - Properties and validators, removing obsoleted code

#19785 Changed methods in ServiceCollectionExtensions to return IServiceCollection instead of void

#19727 Update the existing date/time property editor to provide a kind of unspecified

#19430 Bugfixes/v17/19341 models builder generates different types for color picker value

#19357 Use audit service instead of repository directly in services

#24 [Breaking change]: Removal of unused or unnecessary extension methods

#17051 Clean up extension methods

#16914 Member type container in management API

#15927 Fix nullability of return types that can be non-null
Developer experience
2

#20268 Update Readme to signpost the Forum

#17244 NuGet vulnerability warnings: Warn in non-Release mode, Error in non-Release mode
UI and UX updates
9

#20547 Document/Media Recycle Bin: Show full breadcrumb

#20541 Document/Media: Readonly when in recycle bin

#20523 Make Create Actions open as dialogs (part 2)

#20489 Modals: Make Create Actions open a Dialogs

#20384 Collections: Stop opening items in modals

#20376 Tree: Minimalistic styles for load more

#20261 Adjust styling for inherited content type property

#20258 UX: Add slightly more padding at top so user card outline is not cutoff

#19883 Section Sidebar Menu: Auto expand to paginated tree items (closes #17074)
Other
79

#20542 Management API: Added trashed state so when requesting content from the recycle bin it will return trashed instead of draft or published state

#20535 build(deps): bumps @umbraco-ui/uui from 1.16.0-rc.0 to 1.16.0

#20528 Collection: prevent multiple load calls within a very short time

#20526 Property Editors: DateTimeWithTimeZone - Changing timezone mode to Local shows invalid time zone error

#20519 Notifications: Explicitly flush isolated caches by key for content updates

#20501 UFM: Add camelCase aliases for UFM filters to support UFMJS expressions (closes #20500)

#20485 Performance: Reduce number of database calls in save and publish operations

#20481 Dependencies: Remove `Microsoft.CodeAnalysis.CSharp` dependency from Umbraco.Infrastructure

#20470 Support $index in block UFM labels

#20469 UX: Center align log type in media history view

#20467 You can name Document Types reserved names.

#20455 Content link in breadcrumb does not work

#20438 Icon Picker: Fit icons scroll container to modal height

#20428 Content Workspace: Invariant Breadcrumbs does not work (fix #20423)

#20424 Block Workspace: dynamic headline & browser title

#20423 Breadcrumb navigation completely broken in both Content and Media sections

#20414 Single Block property editor

#20413 Segments: Adds deprecation notices to `AllowNonExistingSegmentsCreation`

#20409 BlockList items are lost on upgrade v13 to v16

#20402 build(deps): bumps @umbraco-ui/uui from 1.15.0 to 1.16.0-rc.0

#20396 UFM: Fixes the truncate filter to only add ellipsis when text is actually truncated (closes #20395)

#20394 Models Builder: Make Models Builder better at not performing "rude edits"

#20392 Collection: hide children of collection until active child

#20386 Dependencies: Updates all npm dependencies for Client, Login, and UmbracoExtension

#20380 Add accessibility label for splitview divider

#20370 Publishing items in bulk programmatically does not properly update delivery api content index

#20366 Content Delivery API returns incorrect route for unpublished variant document in preview mode

#20364 Block Grid: Add icon to allowed block types in area

#20363 Block Grid: Configure minimum one column for areas

#20362 Localization: Added translations for area validation property labels

#20361 Block Grid: Styling of group drag with handle

#20360 Color Picker: Styling for drag handle at swatch items

#20358 Segments: The experience of working with Segments and Segmented Blocks

#20357 Color Picker: Set initial hex value for picker (closes #20326)

#20355 Change to layout of default Content area dashboard

#20351 Entity-Action Bundle: Ensure First Action are updated in rendering

#20346 Media: Prevent svg image to extend outside the editor bounds

#20339 Data Type: Improve missing property editor and property editor UI feedback

#20336 Dictionary Cache Regression

#20333 Extend logging (add delay and period)

#20331 Misleading description in the upload field property editor

#20322 App Plugin Malform JSON - Kills Backoffice completely

#20318 Tiptap RTE: Upgrade to Tiptap v3

#20312 Localization: Fixed message in block group delete confirm modal (closes #20308)

#20310 Log Viewer: Fixes continuous polling (closes #20274)

#20302 Media Workspace Path: add parent path to support absolute path generation

#20301 Models: `PropertyType` constructor sets the `DataTypeKey` if `IDataType` has identity

#20298 Repositories: Retrieve users for groups in batches to fix `UserService.GetAllInGroup` failing on too many users in a group

#20288 Loader bar: Implement loader for Content Workspaces

#20287 Micro-optimization: Move compilation of some Regex generation to compile time instead of runtime, make some static ones compiled

#20274 Log viewer continues polling after closing

#20259 Localization/UX: Add a new general translation for "Fields"

#20257 UX: Make approved colour picker remove button consistent with other multi value item remove buttons

#20251 [V16] - Edit content in full width mode

#20239 Value Presets: also run value presets on load

#20232 Login form: Improves accessibility by removing duplicate label and aria-label

#20228 Slider: improved value fallback handling + validation

#20227 Test Data: Fixing endpoint not working #20044

#20224 Permissions: Added User fallback permission condition (closes #20097)

#20189 Segments: Auto unfold the culture variant in non-culture-variant mode

#20144 Management API: Use EndpointMetadata to check for MapToApiAttribute at runtime to include Controller in Swagger document

#20138 Content Type Designer: Fix moving a group to an inherited tab

#20098 Feature: single block property editor

#20097 `Umb.Condition.UserPermission.Document` does not use fallback permissions for non-document entity types

#20080 Temp/layout header top custom property

#20058 Document Type Editor issues

#20036 V16/bug/20035 validation context uncaught promise

#20007 V17: Update to dotnet 10

#20002 Unable to migrate to V17 on Linux

#19986 Repositories: Introduce and use NPoco and custom extension methods for SQL syntax in ContentTypeRepositoryBase

#19959 V17 - Removed obsoleted code from Umbraco.Cms.Core.Cache & .Routing

#19897 There are several sql syntax issues like hardcode table and column names

#19856 Support persistence of unrestricted selections from the check box list

#19832 SVG image previews in the media library sometimes extend outside the editor bounds

#19707 Use new submit and poll solution for examine index rebuild

#19436 Bugfixes/v17/19341 description update models builder generates different types for color picker value

#19346 Audit service rework

#17262 Switch container to use SQL 2022 instead of SQL Edge

#14499 Adding SourceWidth and SourceHeight to ImageUrlGenerationOptions