Umbraco Forms
CMSCloudHeartcoreDXP
14.latest
14.latest
  • Umbraco Forms Documentation
  • Legacy Documentation
  • Release Notes
  • Installation
    • Installing Umbraco Forms
    • Licensing
  • Upgrading
    • Upgrading Umbraco Forms
    • Version Specific Upgrade Notes
    • Migration IDs
  • Editor
    • Creating a Form - The basics
      • Form Settings
      • Form Information
      • Overview Of The Field Types
        • Date
        • File Upload
        • reCAPTCHA V2
        • reCAPTCHA V3
      • Setting-up Conditional Logic on Fields
    • Attaching Workflows
      • Workflow Types
    • Viewing And Exporting Entries
    • Defining And Attaching Prevalue Sources
      • Prevalue Source Types Overview
  • Developer
    • Property Editors
    • Preparing Your Frontend
    • Rendering Forms
    • Rendering Forms Scripts
    • Themes
    • Custom Markup
    • Email Templates
    • Working With Record Data
    • Umbraco Forms in the Database
    • Extending
      • Adding A Type To The Provider Model
        • Setting Types
      • Adding A Field Type To Umbraco Forms
        • Excluding a built-in field
      • Adding A Prevalue Source Type To Umbraco Forms
      • Adding A Workflow Type To Umbraco Forms
      • Adding An Export Type To Umbraco Forms
      • Adding a Magic String Format Function
      • Adding A Server-Side Notification Handler To Umbraco Forms
      • Adding a Validation Pattern
      • Customize Default Fields and Workflows For a Form
    • Configuration
      • Forms Provider Type Details
    • Webhooks
    • Security
    • Magic Strings
    • Health Checks
      • Apply keys and indexes
      • Apply keys and indexes for forms in the database
    • Localization
    • Headless/AJAX Forms
    • Block List Labels
    • Field Types
    • Storing Prevalue Text Files With IPreValueTextFileStorage
  • Tutorials
    • Overview
    • Creating a Contact Form
    • Creating a Multi-Page Form
Powered by GitBook
On this page
  • Release history
  • 14.2.3 (December 5th 2024)
  • 14.2.2 (November 28th 2024)
  • 14.2.1 (November 21st 2024)
  • 14.2.0 (November 7th 2024)
  • 14.2.0-rc2 November 3rd 2024
  • 14.2.0-rc1 October 25th 2024
  • 14.1.5 (October 3rd 2024)
  • 14.1.4 (September 26th 2024)
  • 14.1.3 (September 19th 2024)
  • 14.1.2 (September 12th 2024)
  • 14.1.1 (August 6th 2024)
  • 14.1.0 (July 23rd 2024)
  • 14.1.0-rc2 (July 18th 2024)
  • 14.1.0-rc1 (July 9th 2024)
  • 14.0.2 (June 11th 2024)
  • 14.0.1 (June 6th 2024)
  • 14.0.0 (May 30th 2024)
  • Umbraco.Forms.Deploy
  • 14.1.1 (October 3rd 2024)
  • 14.1.0 (August 16th 2024)
  • 14.0.0 (May 30th 2024)
  • Legacy release notes

Was this helpful?

Edit on GitHub
Export as PDF

Release Notes

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

PreviousLegacy DocumentationNextInstalling Umbraco Forms

Last updated 3 months ago

Was this helpful?

In this section, we have summarized the changes to Umbraco Forms 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, you can find information about the breaking changes in the article.

Release history

This section contains the release notes for Umbraco Forms 14 including all changes for this version.

(December 5th 2024)

  • Fixed regression introduced in 14.2.1 that caused issues for custom field types overriding the ProcessSubmittedValue method .

(November 28th 2024)

  • Fixed issue with case sensitive checkbox conditions across multi-page forms .

  • Fixed Forms dashboard form title and icon alignment.

(November 21st 2024)

  • Fixed issues with multi-page forms used in conjunction with a FormPrePopulateNotification handler. File uploads and multi-value fields like checkbox lists now function correctly .

  • Added a couple of missing translation keys .

  • Rendered file upload previews in the backoffice.

  • Fixed issue with saving the "Hide field validation labels" value when editing form settings.

  • Fixed issue with selection of Document Type on the "Save as Umbraco node" workflow type.

  • Used correct labels for conditions when used on fields, fieldsets, pages or workflows .

  • All items detailed under release candidates for 14.2.0.

  • Updated dependency on Umbraco CMS to 14.3.0.

Multi-step forms

The 14.2 release of Forms contains features that can improve the user experience of completing multi-page forms.

Form picker enhancements

A second "form details picker" is also available, allowing editors the option of selecting the form, theme and redirect via a single property editor.

Ship themes in Razor Class Libraries

Date picker field type

Umbraco documents prevalue source type

Finer grained entries permissions

Backoffice localization

Other

Other bug fixes included in the release:

  • Reverted entry list to display most recent first.

  • Fixed issue with display of prevalue captions in the entry list.

  • Fixed issue on restoring values of checkbox and radio lists when navigating backward on multi-page forms.

  • Improved cross-platform check when exporting to Excel.

  • Fixed button labels on form copy dialog.

  • Fixed localization of SQL prevalue source labels.

  • Added server-side validation of configured maximum length for short and long answer fields.

  • Restored provision of field values in HTTP headers in Post as XML workflow.

  • Restored the ValueAsString extension method on Record.

  • All issues from earlier 14.1 release candidates.

  • Ordered select list of prevalue sources when defining prevalues for a form field.

  • Limited the field preview for a field containing prevalues.

  • Fixed issue with upload of text file for the prevalue source based on file contents.

  • Added some missing localization keys and translations.

  • Fixed description of management API on Swagger UI.

  • Fixed display of specific form access list for user and group security.

  • Compatibility with Umbraco 14

Umbraco.Forms.Deploy

14.1.1 (October 3rd 2024)

  • Add migrator to add missing Forms editor UI aliases

14.1.0 (August 16th 2024)

  • Add check for keyed services before examining the registered services implementation type (workaround for https://github.com/dotnet/runtime/issues/95789)

  • Request tree items for forms-folder entity

14.0.0 (May 30th 2024)

  • Compatibility with Umbraco 14, Forms 14 and Deploy 14.

Legacy release notes

(November 7th 2024)

Fixed issue with validation for invalid file extension on form submissions via the API .

November 3rd 2024

Added a replacement for the AngularJS . The new implementations use and are .

October 25th 2024

We have added the option for . This will allow those completing forms to get a better understanding of progress as well as see details of the pages still to be completed. .

These options are enabled and configured by editors in the Forms settings section on a per-form basis. We also provide a . In this way, editors can be given access to use the feature only once the styling or theme is prepared.

Another improvement is found in the . We now support restriction of which forms can be selected by folder rather than only by individual forms.

Forms ships it's themes and email templates as part of a razor class library for ease of distribution. With this release we make that feature (or those created by package developers) .

We have made a couple of updates to the Date Picker field type. The format for the field can now be provided in configuration . And you can now override and localize the aria label provided for assistive technologies such as screen readers .

When creating a prevalue source based on Umbraco documents, you can now select custom properties for the value or caption. Previously you had a choice of the content item's Id, Key or Name. We've extended this to allow the selection of any properties defined on the selected Document Type .

To allow finer control over editor permissions, we have introduced a "delete entries" setting for users and user groups. Thus you can now give editors explicit permissions to view, edit, or delete entries .

Finally thanks to a kind contribution from the backoffice is now translated into Dutch .

Fixed issue with single checkbox triggering a condition on a field on a subsequent page .

(October 3rd 2024)

Handled "chunked" authentication cookie in protection of file uploads saved in the media file system .

Ensured field list for condition rules updates as new fields are added to the form .

Resolved issues with requesting management API endpoints for forms from content without access to the Forms section .

(September 26th 2024)

Fixed regression in 14.1.2 that caused validation to fire on the wrong form when multiple forms are hosted on a single page .

Fixed issue with line breaks in form submissions breaking the entries view .

(September 19th 2024)

Fixed regression in 13.2.0 that prevented a form submission from saving if a workflow approved the entry .

Added file name validation to file uploads, rejecting files with invalid colon characters .

(September 12th 2024)

Added configurable field level rendering of reCAPTCHA 3 validation result .

Fixed validate and submit script to handle additional markup around submit buttons .

Fixed incorrect concatenation of field CSS classes .

Fixed issue with recording of form submissions in custom Examine indexes .

Added ability to retrieve "slim" workflow entities from services .

Fixed the following backoffice user interface issues , , , , , and .

(August 6th 2024)

Fixed issues with entries export for Windows installations without access to a component necessary for auto-fit of Excel columns .

Resolved intermittent issues with display of entries list .

Restored access to setting option for sensitive data handling in workflows .

Fixed validation on saving a form without a name .

Fixed fallback of the localized user interface for English (GB) to English (US) .

Fixed issue with form block rendering from rich text content .

(July 23rd 2024)

The 14.1.0 release contains minor changes to the mark-up in the following Razor files shipped with the product: Form.cshtml, FieldType.RadioButtonList.cshtml, and FieldType.CheckBoxList.cshtml. These changes were made to resolve issues and .

Please ensure to check the rendering of these features on website forms after the upgrade. If you need to view the files to compare changes, you can download and view the and versions.

Ensured prevalues can be retrieved outside of an HTTP request context when they depend on a static root node .

(July 18th 2024)

Added configuration option AllowedFileUploadExtensions to provide an "allow list" of extensions that will be accepted in file uploads via forms .

Read more about this and related settings .

Allowed users without sensitive data permissions to set, but not remove, the sensitive flag on a form field .

Improved support for editing large, multi-page forms by retaining scroll position between views and adding a "jump to page" option .

(July 9th 2024)

Added setting option for single and multiple choice fields to allow for vertical or horizontal display

Updated themes such that accessibility is improved by having hidden labels remain in markup but be visually hidden .

Added new setting type for multiple text strings

Added validation to prevent users defining an email workflow that allows the form's sender email to be defined as that entered by the user

Allowed for the provision of additional data when rendering and submitting forms. When provided it will be used as a source for . The data will be associated with the created record and made available for custom logic and update within workflows.

Added details of workflow type to edit workflow dialog

Allowed for use of prevalue sources that customize based on the current form or field in backoffice editing and preview

Ensured links to Umbraco pages within rich text fields used for emails are correctly parsed .

Added body rich text field for send email with Razor template workflow .

Fixed console error with blank values in the date picker field .

Ensured placeholders are parsed for accepted entry response from the delivery API .

Resolved issues with intermittent failures of the form entries table display .

(June 11th 2024)

(June 6th 2024)

Ensured local links are parsed when HTML fields are returned in the delivery API results for form definitions .

Restored target used to generate local configuration schema information .

Resolved duplicate approval occurring when the record is approved via a workflow .

(May 30th 2024)

See full details of breaking changes under the .

You can find the release notes for versions out of support in the and .

Forms issue tracker
Version Specific Upgrade Notes
14.2.3
#1328
14.2.2
#1325
14.2.1
#1317
#1320
#1316
#1319
#1323
14.2.0
#1310
14.2.0-rc2
block list label filter we provide for Forms 13
Umbraco Flavored Markdown (UFM)
documented here
14.2.0-rc1
form picker property editors
#1276
#1082
#1195
#1303
Erik-Jan Westendorp
#1264
#1304
14.1.5
#11
#1301
#1244
14.1.4
#1297
#1296
14.1.3
#1293
#1295
14.1.2
#1277
#1280
#1284
#1282
#1283
#1291
#1290
#1288
#1287
#1286
#1278
#1275
14.1.1
#1259
#1256
#1262
#1263
#1267
#1268
14.1.0
#1220
#1218
latest
previous
#1258
14.1.0-rc2
#1252
#1233
#1243
14.1.0-rc1
#1218
#1220
#1217
#1210
"magic string" replacements
#578
#1183
#1221
#1208
#1198
#1241
#1238
#1239
14.0.2
14.0.1
#1227
#1226
#1223
14.0.0
Version-specific Upgrade Guide
Legacy documentation on GitHub
Umbraco Forms Package page
#281
#648
#795
available to your own custom themes and templates
editors to choose to display paging details on the forms
configuration-based toggle for the feature as a whole
here