Umbraco UI Builder
CMSCloudHeartcoreDXP
13.latest (LTS)
13.latest (LTS)
  • Umbraco UI Builder Documentation
  • Known Issues
  • Release Notes
  • Installation
    • Installing Umbraco UI Builder
    • Licensing
  • Upgrading
    • Upgrading Umbraco UI Builder
    • Version Specific Upgrade Notes
    • Migrate from Konstrukt to Umbraco UI Builder
  • Getting Started
    • Overview
    • Configuration
    • User Interface
  • How-to Guides
    • Creating your first integration
  • Areas
    • Overview
    • Sections
      • Summary Dashboards
    • Trees
      • Folders
    • Dashboards
    • Context Apps
  • Collections
    • Overview
    • The Basics
    • List Views
      • Field Views
    • Editors
    • Child Collections
      • Child Collection Groups
      • Retrieve Child Collections
    • Related Collections
    • Entity Identifier Converters
  • Searching
    • Overview
    • Searchable Properties
  • Filtering
    • Overview
    • Global Filters
    • Data Views
      • Data Views Builders
    • Filterable Properties
  • Actions
    • Overview
    • The Basics
    • Action Visibility
    • Inbuilt Actions
  • Cards
    • Overview
    • Count Cards
    • Custom Cards
  • Property Editors
    • Overview
    • Entity Picker
  • Advanced
    • Virtual Sub Trees
    • Encrypted Properties
    • Value Mappers
    • Repositories
    • Events
  • Miscellaneous
    • Conventions
    • Umbraco Aliases
Powered by GitBook
On this page
  • Release History
  • Legacy release notes
Edit on GitHub
Export as PDF

Release Notes

Get an overview of the things changed and fixed in each version of Umbraco UI Builder.

PreviousKnown IssuesNextInstalling Umbraco UI Builder

Last updated 17 days ago

In this section, we have summarized the changes to Umbraco UI Builder released in each version. Each version is presented with a link to the showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.

If you are upgrading to a new major version, check the breaking changes in the article.

Release History

This section contains the release notes for Umbraco UI Builder 13 including all changes for this version.

(April 30th 2025)

  • Added localization for tree headers and list views empty state message

(April 4th 2025)

  • Removed global registration of UDI converters and introduced new .

(March 21st 2025)

  • Fixed an issue for bulk actions that disabled the actions row on cancel

  • Extended UdiConverter with options to convert to GUID

(March 17th 2025)

  • Added the ActivatorUtilitiesConstructor attribute to the ImportActionEntity constructor.

(March 4th 2025)

  • Updated licensing engine.

  • Added updates to the licensing engine.

  • Added previously validated license resolver, to validate a license if a validation process was already executed successfully in the past 7 days.

  • Fixed an issue caused by where clauses for filter expression and deleted property.

  • Allow renaming the heading of the implicit Name column by calling the SetNameProperty method overload.

  • Use CsvHelper library with the built in ExportEntityAction.

  • Update CsvHelper version dependency.

  • All updates listed under 13.1.0-rc1 and 13.1.0-rc2.

While working with a custom repository, the entity ID type converter defaulted to the newly registered UdiConverter instead of Int32Converter. With the current update, the required converter will be picked in a different order.

Umbraco UI Builder 13.1 is the first release since launch adding new features. We've focussed on improving the experience when working with related collections, addressing some additional use cases that widen the scope of the product. This includes the possibility to retrieve child collections entities or use an Umbraco entity as foreign key.

  • Related Collections

This feature provides support for managing many-to-many relationships by configuring main, related and junction entities.

  • Retrieve Child Collections

This feature addresses a one-to-many relationship context. Having a parent collection with child sub-collections, one might need to retrieve the child collections only, without fetching the details of the parent.

  • Implementation of a UdiConverter

This update addresses the configuration of collections that use as foreign key a reference to an Umbraco entity. If the FK type is Integer, the persisted value defaults to 0. This is because the UDI value of the entity cannot be converted from String to Int. Based on the UDI value, we are retrieving and persisting the Id of the Umbraco entity.

  • Dependency version update for Umbraco.Licenses

  • Upgraded to run again Umbraco v13 and .NET 8

  • Upgraded all 3rd party dependencies

  • Nullable references

Legacy release notes

Fixed issue with import entity action for Umbraco Cloud websites

(January 22nd 2025)

(December 16th 2024)

Allow entity properties to be searched based on pattern: StartsWith | Contains

Switch entity create/edit header to label view for read-only collections

(June 17th 2024)

Fixed an issue that did not allow a readonly field to be added multiple times to an editor

(May 13th 2024)

Added support for using properties of nested objects as searchable

You can read more about this in the article.

(May 8th 2024)

Fixed an issue with the UdiConverter affecting child collections

(April 23rd 2024)

Fixed an issue with nested objects in collection entities

Fixed an issue with the UdiConverter causing website configuration binding to return incorrect values

(March 18th 2024)

Fixed an issue where the database is getting disposed in a UIBuilder repository, causing an error when Forms tries to save the form submission after the workflow is complete .

You can read more about this in article.

(March 6th 2024)

(February 26th 2024)

Upgrade from 13.0.3 to 13.1.0-rc1 breaks existing custom repository.

(February 20th 2024)

You can read more about this in the article.

You can read more about this in the article.

A use case can be found in the .

(February 20th 2024)

(January 26th 2024)

Doesn't work after upgrading to 13.0.3

Dependency issue when installing UIBuilder alongside Umbraco Commerce in a v13 Umbraco website

Dependency issue when installing UIBuilder alongside uSync in a v13 Umbraco website

Fields in Sidebar are not included when creating item

(January 11th 2024)

Fix built-in export/import actions errors

Update list view editorState to support integration with Contentment Data Types

(December 13th 2023)

You can find the release notes for Konstrukt in the .

UI Builder issue tracker
Version Specific Upgrade Notes
13.2.4
#115
13.2.3
#144
Entity Identifier Converters
13.2.2
#130
#108
13.2.1
13.2.0
#92
13.1.7
13.1.6
#116
#111
13.1.5
#105
13.1.4
#97
searchable properties
13.1.3
#99
13.1.2
#97
#96
13.1.1
Umbraco.Forms.Issues#1179
the basics
13.1.0
13.1.0-rc2
#91
13.1.0-rc1
related collections
retrieve child collections
GitHub issue #86
13.0.3
13.0.2
#88
#82
#85
#82
13.0.1
#84
#83
13.0.0
Change log file on GitHub