Umbraco Forms
CMSCloudHeartcoreDXP
15.latest
15.latest
  • Umbraco Forms Documentation
  • Legacy Documentation
  • Release Notes
  • Installation
    • Installing Umbraco Forms
    • Licensing
  • Upgrading
    • Upgrading Umbraco Forms
    • Version Specific Upgrade Notes
  • Editor
    • Creating a Form - The basics
      • Form Settings
      • Form Advanced Options
      • 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
  • 15.1.2 (May 13th 2025)
  • 15.1.1 (March 7th 2025)
  • 15.1.0 (January 16th 2025)
  • 15.1.0-rc3 (December 20th 2024)
  • 15.1.0-rc2 (December 20th 2024)
  • 15.1.0-rc1 (December 17th 2024)
  • 15.0.3 (December 5th 2024)
  • 15.0.2 (November 28th 2024)
  • 15.0.1 (November 21st 2024)
  • 15.0.0 (November 14th 2024)
  • 15.0.0-rc4 (November 13th 2024)
  • 15.0.0-rc3 (November 6th 2024)
  • 15.0.0-rc2 (October 18th 2024)
  • 15.0.0-rc1 (October 8th 2024)
  • Umbraco.Forms.Deploy
  • 15.1.0 (January 23rd 2025)
  • 15.1.0-rc1 (December 17th 2024)
  • 15.0.0 (November 14th 2024)
  • 15.0.0-rc4 (November 13th 2024)
  • 15.0.0-rc3 (November 7th 2024)
  • 15.0.0-rc2 (October 24th 2024)
  • 15.0.0-rc1 (October 14th 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 12 days 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 15 including all changes for this version.

(May 13th 2025)

  • HTML encode submitted values in 'Send Email' workflow

  • Omit file path from export endpoint result

  • Fix selectable items in dialogs

  • Fix API error in security condition

(March 7th 2025)

  • Ignore existing corrupt record data and ensure proper JSON serialization when storing entries with forged data

  • Parse magic string placeholders in advanced validation rule error message

  • Only parse magic string placeholders in field mapping static values (fixes JSON deserialization error)

  • Fix invalid CreatedBy and UpdatedBy column name errors in migration by getting 'slim' objects from repository

  • Fix export file path generation and checking (enhances Linux/Docker compatibility)

  • All items detailed under release candidates for 15.1.0.

  • Resolved minor backoffice issues when creating and saving prevalue and data sources.

Validation rules across form fields

When creating forms you are able to add validation to individual fields, making them mandatory or applying a regular expression pattern. With the 13.4 release we are looking to make this more powerful, by allowing the addition of validation rules for the entire form. The idea is that this will allow you to validate expressions based on multiple fields. For example, "these two email fields should be the same", or "this date should be after this other one".

When the form is rendered, the validation rules will be applied on the client, where we support both the aspnet-client-validation and jquery.validate libraries. They are also verified server-side. In this way you can ensure the submission is only accepted if it meets the requirements.

Feedback on this feature in particular is welcome.

Tracking editor activity

Copy of workflows

File upload validation messages

Other

Other bug fixes included in the release:

  • Fixed Forms dashboard form title and icon alignment.

  • Fixed issue with creation of folder for forms.

  • 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.

  • Compatibility with Umbraco 15.0.0

  • Compatibility with Umbraco 15.0.0-rc4

  • Compatibility with Umbraco 15.0.0-rc3

  • Preview of features and bug fixes due in 13.3 and 14.2:

    • Added Umbraco Flavoured Markdown component for the rendering of form names within a block list

  • Compatibility with Umbraco 15.0.0-rc2

  • Preview of features and bug fixes due in 13.3 and 14.2:

    • Improve cross-platform check when exporting to Excel.

  • Compatibility with Umbraco 15.0.0-rc1

  • Preview of features due in 13.3 and 14.2:

    • Option to display paging details for multi-page forms.

    • Form picker with allowed forms managed via folders.

    • New "form details picker" providing a single property editor for the selection of form, theme, and redirect.

Umbraco.Forms.Deploy

This Deploy add-on adds support for transferring, restoring, exporting and importing (including migrating between major versions) of Umbraco Forms data.

15.1.0 (January 23rd 2025)

  • All items from 15.1.0-rc1

15.1.0-rc1 (December 17th 2024)

  • Set the form entities created/updated by to the resolved user when deploying (requires Umbraco Forms 15.1)

15.0.0 (November 14th 2024)

  • Update Forms and Deploy dependencies to 15.0.0

15.0.0-rc4 (November 13th 2024)

  • Update Forms and Deploy dependencies to 15.0.0-rc4

15.0.0-rc3 (November 7th 2024)

  • Update Forms and Deploy dependencies to 15.0.0-rc3

15.0.0-rc2 (October 24th 2024)

  • Update Forms and Deploy dependencies to 15.0.0-rc2

15.0.0-rc1 (October 14th 2024)

  • Update Forms and Deploy dependencies to 15.0.0-rc1

Legacy release notes

(January 16th 2025)

(December 20th 2024)

Rendered a hidden submit button on multi-page forms. Ensures that a default button to go forward is used when submitting a form via return key press or a mobile "Go" button .

(December 20th 2024)

Used the name and description defined on the setting attribute for backoffice labels when no client-side localization is available .

Resolved issue where maximum length check on input field was applied to incorrect field .

(December 17th 2024)

Crafting these rules requires use of so is considered a "power user" feature. They also require an additional front-end dependency for the rendering of forms on the website. As such they are surfaced on a new "Advanced" tab and only visible and used if enabled in configuration. We don't have, and it seems difficult to provide, an intuitive user interface for rule creation taking into account all the flexibility available. Nonetheless, having the ability to use more complex validation rules seems a valuable addition.

Read more about as well as the .

Whilst previously we tracked and displayed the date a form was created and last edited, we didn't show who had made these updates. With 15.1 installed we will start to track this and display the information where available. You'll find this on the form, data source or prevalue source's "Info" tab .

Forms allows you to make a copy of a form to use as a starting point for a new one. You can choose whether or not to copy workflows along with the form. With the 15.1 release, we've made available a second dialog allowing you to copy workflows to an existing form . You can select any or all of the workflows on the current form and copy them to the selected destination form.

We've also resolved an edge case around copying a form. It's possible to . Copying the form without workflows excludes the desired workflow. You would have a form that didn't contain the workflow you wanted to be included on all. This has been tightened up now and mandatory workflows will always be assigned to the copied form .

Previously the validation messages presented on the website front end when uploading files were hardcoded and always provided in English. We've added settings now to the "File Upload" field type allowing you to customize these. Dictionary keys can be used in order to provide the information in the user's preferred language .

Fixed issue with applying links to rich text settings on custom field or workflow types .

(December 5th 2024)

Fixed regression introduced in 15.0.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 .

Migrated rich text features to use the CMS's Tiptap editor .

(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 .

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

(November 14th 2024)

(November 13th 2024)

(November 6th 2024)

Fixed issue where sensitive data flag on a field could not be set for new fields added to a form

Added date picker setting to set the text for the aria-label

Allow selection of custom fields for values and captions for pre-value sources based on Umbraco documents

Added validation message when submitting a form via the API with an invalid file extension

(October 18th 2024)

Permission for delete entries .

Configurable date format for date picker field .

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

(October 8th 2024)

See full details of breaking changes under the .

Made retrieval of prevalue source values and execution of record exports asynchronous .

Ability to provide custom themes and email templates via razor class libraries .

Backoffice translations for Dutch .

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

Forms issue tracker
Version Specific Upgrade Notes
15.1.2
GHSA-2qrj-g9hq-chph
#1377
#1389
15.1.1
15.1.0
15.1.0-rc3
#1343
15.1.0-rc2
#1336
#1342
15.1.0-rc1
JSON logic
#1315
#1185
#1327
#1329
15.0.3
#1328
15.0.2
#1325
#1326
15.0.1
#1317
#1320
#1316
#1319
#1323
15.0.0
15.0.0-rc4
15.0.0-rc3
#1309
#1082
#1195
#1310
15.0.0-rc2
#1303
#1276
#1304
15.0.0-rc1
Version-specific Upgrade Guide
#1285
#795
#1264
Legacy documentation on GitHub
Umbraco Forms Package page
editing advanced validation rules
#1331
define workflows as mandatory
configuration option required to enable them