Version Specific Upgrade Notes
Version specific documentation for upgrading to new major versions of Umbraco Forms.
This page covers specific upgrade documentation for when migrating to major 13 of Umbraco Forms.
If you are upgrading to a new minor or patch version, you can find information about the breaking changes in the Release Notes article.
Version Specific Upgrade Notes History
Version 13 of Umbraco Forms has a minimum dependency on Umbraco CMS core of 13.0.0
. It runs on .NET 8.
Deploy add-on for Umbraco Forms has been renamed from Umbraco.Deploy.Forms
to Umbraco.Forms.Deploy
.
Breaking changes
Version 13 contains a number of breaking changes. If you do run into any, they should be straightforward to adjust and recompile.
For reference, the full details are listed here:
Behavior
The configuration option
UseSemanticFieldsetRendering
was removed and considered astrue
. This means the improved, semantic fieldset rendering is now used in the default theme for all installations.The
ExecuteWorkflowAsync
configuration option was removed.
Dependencies
Umbraco CMS dependency was updated to
13.0.0
.
Code
The following updates describe the more significant changes to the codebase and public API:
Amended
IWorkflowExecutionService
,IRecordService
,IRecordSetActionType
andIWorkflowType
methods related to workflow execution to be asynchronous. These methods now have anAsync
suffix and will return a awaitableTask
.An overload for the HTML helper
RenderUmbracoFormDependencies
that internally required service location was removed. It should now be called providing the parameter for anIUrlHelper
, with@Html.RenderUmbracoFormDependencies(Url)
.
These updates are more minor. We don't expect many projects to be affected by them as they are in areas that are not typical extension points:
DataSourceCacheRefresher
was made internal.HideField
was removed fromFieldType
andIFieldType
.RenderInputType
with a value ofRenderInputType.Hidden
can be used here instead.The default implementation for the
Exists
method previously added toIBaseService
was removed.The obsolete overload for method
AddDataConsentField
onFieldsetContainerExtensions
was removed.The method
CanUserViewEntries
was added to theIFormsSecurity
interface.The static methods
TryCreateAttachment
,TrackAttachmentFileStream
andDisposeAttachmentFileStreams
onBaseEmailWorkflowType
were removed (instance methods are available to use instead).The obsolete constructor on the
SaveAsFile
workflow type was removed.The obsolete overload for method
TransformXML
onXsltHelper
was removed.The obsolete overloads for method
ValidateField
onFieldType
were removed.The obsolete overload for method
GetFormSecurityByUserId
onFormSecurityControllerBase
was removed.The
PopulatePageElements
method was added to theIFormRenderingService
interface.The
Setting
class was renamed toSettingAttribute
.PreValueFileController
has a changed constructor.FileUpload
has a changed constructor.ExecuteWorkflowsWithResult
onIWorkflowExecutionService
was renamed toExecuteWorkflows
and the void method with that name was removed.The string constants used to define GUIDs for each provider type were made consistently upper-case.
FileUpload
andPreValueFileController
have changed constructors to add support for server-side file validation.HTML helpers such as
RenderFormsScripts
now returnIHtmlContent
.The constructor for workflow notifications was amended to add a parameter for the current
Record
.The
IType
interface now defines aCreated
property.
Legacy version specific upgrade notes
You can find the version specific upgrade notes for versions out of support in the Legacy documentation on Github.
Last updated