Umbraco-CMS v17.3.1 release notes

Viewing: Umbraco-CMS v17.3.1

Released: Wednesday, April 8 2026

Release notes for Umbraco-CMS v17.3.1

Released on: Wednesday, April 8 2026

NuGet Package: Umbraco.Cms v17.3.1

Install and upgrade guidance

Quick install instructions This link leads to a site made by members of the Umbraco community, it helps make the installation of Umbraco a lot easier for you.
Upgrade guide

Other 4

#22355 Umbraco 17.3 regression: crashes on startup if wwwroot/media/ directory doesn't exist

release/17.3.1

by hifi-phil created on Apr 6, 2026

Fixed in

#22281 Install: Ensure media directory exists before creating `PhysicalFileProvider` (closes #14877, #22355)

#22349 After upgrading from 17.2.2 to 17.3.0 I am unable to select a folder with the media picker.

type/bug

state/reproduced

affected/v17

release/17.3.1

by rdjohnston-sjgov created on Apr 3, 2026

Fixed in

#22350 Media Picker: Fix folder selection regression for developer-configured media pickers (closes #22349)

Also fixes

#21885 V17 Unable to select a media folder as an "Image Upload Folder"

#22344 UmbracoBuilderExtensions.AddWebComponents() should be idempotent: duplicate umbraco-ready health check registration when combined with AddBackOffice()/AddCore()

type/bug

release/17.3.1

by giano574 created on Apr 3, 2026

Fixed in

#22347 Builder Extensions: Make `AddWebComponents()` idempotent (closes #22344)

#22339 Upgrade to V17.3 have sql exception

type/bug

affected/v17

release/17.3.1

by laputaworkuk created on Apr 2, 2026

Fixed in

#22340 Document URL Service: Batch delete of obsolete URL segment records to avoid SQL Server parameter limit (closes #22339)