59 votes

Umbraco Forms

Everyone deserves a form creator that's as easy to use as Umbraco, so we built just that. Whether it's a simple contact form or an advanced multi-step questionnaire that integrates with 3rd party services - it'll be a breeze.



Creating forms is as easy as editing content in Umbraco and it's a seamlessly integrated experience. You can select from a range of well known input types, select validation rules, and even conditions - for instance "only show this field if the visitor answered 'Yes'". All through an intuitive and robust user interface.


While it's nice to gather data, it's even better when it's put to use. That's why Umbraco Forms lets you setup advanced workflows that can send e-mails, update webservices, save in CRM systems, and much more.


Once your visitors have filled out forms, you can easily browse and search through the data using the built-in reporting tool or download the data for more advanced processing in Microsoft Excel or Google Spreadsheets.

Version info

  • Forms Version 9.x supports Umbraco versions 9.0+
  • Forms Version 8.x supports Umbraco versions 8.0+
  • Forms Version 7.x supports Umbraco versions 7.9 -> 7.x
  • Forms Version 6.x supports Umbraco versions 7.6+
  • Forms Version 4.x supports Umbraco versions 7.1 -> 7.5.x


Forms version 8 and below can be installed from NuGet at the following feed:
As well as from this page on our.umbraco.com.
Forms version 9 can only be installed from NuGet at the following feed:


9.0.0 (September 27th 2021)

  • V9 release on .NET 5 compatible with CMS V9.

8.8.0 (September 14th 2021)

  • All updates listed for 8.8.0-rc001
  • Better handle deleted form when content linked to that form #635
  • Fixed issue with re-submitted edited form records that include file uploads #632
  • Added validation message when a file upload is configured to accept no file types #631
  • Updated styling of form page and group titles to better indicate that they are editable #636
  • Fix for incorrect validation of mandatory file upload fields #110

8.8.0-rc001 (August 19th 2021)

  • Structure forms in folders #75
  • Fixed conditional field value being recorded when conditions not met #292
  • Autocomplete attributes for forms and fields #322
  • Workflow UX tidy-up #334
  • Fixed prevalue sources not finding grandchildren #365
  • Configuration of a default theme #398
  • Added busy indicator when exporting to Excel and performing record set operations #419 #575
  • Ensured form submissions with message display follow post/redirect/get pattern #485 #572 #593
  • Added ability to toggle field labels #530
  • Added link to page where form was submitted from back-office entry screen #607
  • Fixed icons for answer types display #610
  • Fixed display of grid picker form preview #612
  • Ensured workflow settings updates saved only when submitting and not closing dialog #613
  • Fixed issue with conditional fields when forms are copied #624
  • Fixed issue with settings validation of prevalues with custom field types #627

4.4.9, 6.1.0 (August 3rd 2021)

  • Resolved regression issue introduced by security patch for uploaded media paths.

4.4.8, 6.0.9, 7.0.7, 7.1.4, 7.2.1, 7.3.2, 7.4.3, 7.5.4, 8.0.2, 8.1.6, 8.2.3, 8.3.4, 8.4.4, 8.5.7, 8.6.2, 8.7.6 (July 20th 2021)

  • Resolution of security vulnerability (see blog post).

8.7.5 (July 6th 2021)

7.5.3 (July 6th 2021)

8.7.4 (June 15th 2021)

7.5.2 (June 1st 2021)

8.7.3 (May 18th 2021)

8.7.2 (May 11th 2021)

7.5.1 (Apr 27th 2021)

8.7.1 (Apr 13th 2021)

8.7.0 (Apr 6th 2021)

7.5.0 (Apr 6th 2021)

8.7.0 (RC) (Mar 23rd 2021)

Breaking changes:

  • In introducing CC and BCC email addresses for workflow based email sending (#457), we've needed to add a new method to IWorkflowEmailService.  If anyone has a custom implementation of this interface, it will need to be amended to implement this new method. 

8.1.5, 8.2.2, 8.3.3, 8.4.3 (March 16th 2021)

  • Enabling older forms version to work with the most recent Umbraco Deploy

8.6.1 and 7.4.2 (Feb 23rd 2021)

8.6.0 (November 24th 2020)

8.5.5 (November 10th 2020)

8.5.4 (October 27th 2020)


8.5.3 (September 10th 2020)

  • Small extra check while upgrading to avoid duplicates

8.5.2 (September 7th 2020)

  • #387 - V8: Exceptions when upgrading.
  • #393 - V8: Form edits cannot be saved.​

​8.5.1 (August 7th 2020)

  • Note: this release has been removed for now while we fix upgrade bugs
  • Fixed a null reference bug related to workflows.​

8.5.0 (August 6th 2020)
8.5.0 Changelog

  • Note: this release has been removed for now while we fix upgrade bugs
  • #321 - V7/V8: Changes to improve "magic strings" usage in 7.4.0/8.4.0 don't work as expected
  • #339 - V8: Error on GetFieldTypeByField when rebuilding forms index / removing entries
  • #342 - V8: Form submissions fail in latest version 


8.4.2 (August 7th 2020)
8.4.2 Changelog

8.4.1, 7.4.1 (April 28th 2020)
8.4.1 Changelog
7.4.1 Changelog

  • #321 - V7/V8: Changes to improve "magic strings" usage in 7.4.0/8.4.0 don't work as expected
  • #339 - V8: Error on GetFieldTypeByField when rebuilding forms index / removing entries
  • #342 - V8: Form submissions fail in latest version 


8.4.0, 7.4.0 (March 31st 2020)
8.4.0 Changelog
7.4.0 Changelog

  • #305 - Can't remove entry when fields in form has changed
  • #299 - Workflow save to content with dropdown data type
  • #296 - Umbraco's PreviewBadge is added to the notification email
  • #295 - unescape() added to 8.3.1 is deprecated
  • #294 - Store/retrieve field values in single SQL batch
  • #277 - Date Picker selection not validating as matching a field condition
  • #276 - Group condition settings clearing on close of infinite window
  • #228 - Unable to delete form entries & rebuild form data
  • #132 - NuGet package includes EPPlus.dll and dependency
  • #120 - Magic string for form field does not use alias
  • #52 - Forms: Fields marked as sensitive is included in emails

8.3.2 (March 23rd 2020)

  • Fixes a concurrency issue with workflows

8.3.1 (February 11th 2020)

7.3.1 (February 11th 2020)

8.3.0 (January 28th 2020)

7.3.0 (January 28th 2020)

8.2.0 (01 October 2019)

7.2.0 (01 October 2019)

8.1.3 (10 September 2019)

7.1.3 (10 September 2019)

8.1.2 (27 August 2019)


7.1.2 (27 August 2019)


8.1.1 (2 April 2019)

7.1.1 (2 April 2019)


8.1.0 (26  March 2019)

7.1.0 (26 March 2019)
8.0.0 (25  February 2019)
  • V8 support
7.0.6 (22 January 2019)

7.0.5 (1 October 2018)

  • A very specific Umbraco Cloud bug was fixed in this release, does not affect stand-alone installs

7.0.4 (11 Septempber 2018)

  • CON-1221 — Form condition validation issue when used in conjunction with FileUpload FieldType
  • CON-1534 — Inconsistent path case casing issues when using Azure blob storage for file uploads.
  • CON-1562 — Export of sensitive data
  • CON-1555 — Add alias of the Form field to the FieldViewModel

7.0.3 (15 May 2018)

6.0.8 (15 May 2018)

4.4.7 (15 May 2018)

7.0.2 (24 April 2018)

  • CON-1523 — Upgrading Umbraco while there is also a Forms upgrade pending leads to loads of app pool restarts

7.0.1 (27 March 2018)

  • CON-941 — Google reCaptcha 2
  • CON-1252 — SendEmail Workflow don't find uploaded file to attach in Azure Storage

7.0.0 (27 Feb 2018)

  • CON-1496 — Form fields can be marked as sensitive
  • CON-1483 — Option of not storing the submitted data on the form in the Forms data store
  • CON-1490 — Hide sensitive data based on security and from exported data

6.0.7 (27 Feb 2018)

  • CON-1199 — Render scripts in the bottom
  • CON-1268 — "Send Mail" Workflow not active, but e-mail is still sent.
  • CON-1339 — Support for SQL Based Session State
  • CON-1452 — UI Overlay bug after installing Forms
  • CON-1472 — Buy Forms, call to action button is grey
  • CON-1473 — TLC for configure license screen
  • CON-1476 — Static value not restored when updating 'Save as content node' workflow
  • CON-1480 — Magic string as static value for 'Save as content node' workflow doesn't work.

6.0.6 (9 Jan 2018)

  • CON-1418 — RecordStorage.UpdateRecord - Does not regenerate JSON for RecordData for entries viewerCON-1456 — Infinite restart loop when using virtual App_Data

6.0.5 (23 Oct 2017)

This release is a patch release containing a few bug fixes due to regression issues found with the 6.0.4 release, if you are using 6.0.4 you should upgrade to 6.0.5 as you will be affected by a couple of issues.

To see the full list of changes check this list on the tracker: 


6.0.4 (13 Oct 2017)

This release is a patch release containing several bug fixes and a new feature allowing you to pre-populate form fields using a new c# event and a new Form picker for the Grid.

To see the full list of changes check this list on the tracker: 


6.0.3 (19 September 2017)

This release contains no changes whatsoever. We had to create this release so we could make a new NuGet version that was less restrictive. 6.0.2 could not be installed in Umbraco 7.7.0 due to this restriction. So the only change in 6.0.3 is that the NuGet package no longer has this restriction.

6.0.2 (27th June 2017)

This is a patch release version, fixing a few bugs, and extending some of helper methods that makes it easier to load client side assets and methods for easier working with settings.

The full list of changes for this release can be viewed here:

6.0.1 (4th May 2017)

This is a patch release, as unfortunately version 6.0.0 shipped with an older internal build of a DLL, as this was missing a fix containing to help ensure upgrades go smoothly, ap[art from this it contains no other changes.

6.0.0 (2nd May 2017)

What happened to version 5? ... naturally we'll always skip a v5 :)

This is a major version release because it has a new minimum Umbraco CMS version dependency on Umbraco 7.6.0 and there are a couple of breaking changes. If you are using Umbraco 7.6+ you will need a minimum of Umbraco Forms v6.0.0. If you are using < Umbraco 7.6 you cannot use Forms 6.0.0 and you will need to continue to use 4.x

Here are the specific upgrade instructions provided for upgrading from 4.x to 6.0.0

Here is the list of breaking changes

This version includes two new shiny features:
Themes - Which allow for a much easier way to style & customise your Forms

HTML Email Templates using Razor - Say goodbye to XSLT & hello to Razor to build & customise your emails post form submissions

The full list of changes in this release can be viewed here:

4.4.6 (9 Jan 2018)

  • CON-1418 — RecordStorage.UpdateRecord - Does not regenerate JSON for RecordData for entries viewer

4.4.5 (23rd Oct 2017)

This release is a patch release containing bug fixes

To see the full list of changes check this list on the tracker: 


4.4.4 (17th Oct 2017)

This release is a patch release containing bug fixes

To see the full list of changes check this list on the tracker: 


4.4.3 (27th June 2017)

This release is a patch release, containing all the backportable patches done in version 6, and fixes quite a few ones found in version 4.4.x.

To see the full list of changes check this list on the tracker: 



Security Release - 4.4.2 (1st March 2017)

High priority security upgrade. All versions of Umbraco Forms are affected and you should upgrade immediately.


4.4.0 (30th November 2016)

This release has been a long time coming but it includes lots of bug fixes that the lovely community has reported to us, along with a new feature of an IFileSystem to store your Umbraco form JSON files. Used in combination with the community Azure Blob Storage Provider to have all your forms stored in the cloud for example.

For more details on the Forms IFileSystem provider you can read about it here in the doucmentation - https://our.umbraco.org/documentation/Add-ons/UmbracoForms/Developer/IFileSystem


Want to know what is in this release, well wonder no more:


Security Release - 4.3.3, 4.2.2 & 4.1.6 (13th October 2016)

High priority security upgrade. All versions of Umbraco Forms are affected and you should upgrade immediately.


4.3.2 (8th June 2016)

Hey wait a minute, didn't you guys just release a patch literally yesterday. Yes we did & unfortunately we make mistakes, a couple of minor issues effecting only certain customers was effected & slipt through the net for the 4.3.1 patch from yesterday.

Want to know what is in this patch, well wonder no more:


Breaking Change Note in 4.3.2

Unfortunately we have introduced a breaking change with issue CON-1085. The new xPAth selector shortcuts $site and $current work however has broken legacy selectors such as


and for the time being should use


To follow the progress of this issue you can see CON-1098


4.3.1 (7th June 2016)

Unfortunately we experienced a few hiccups with the 4.3.0 release and this minor release fixes up the issues that some users may be experiencing.

For the full list of changes in this release see here



4.3.0 (2nd June 2016)

The beta of Forms 4.3.0 was successful with minor bug fixes, fixed up by the reporters on the issue tracker. So thank you for logging the issue you have found.

Since the beta release we have fixed a further 14 issues, to make this one fantastic release of Umbraco Forms.

For the changes since the Beta see here

For the full list of changes in this release see here


4.3.0 Beta (20th May 2016)

New UI overhaul inline with Umbraco 7.4 - Form Designer, Workflow Designer & Entries viewer have recieved UI & UX improvements when used in Umbraco sites higher than 7.4.

This release includes alot of behind the scenes improvements & bug fixes.

For a full list of changes in 4.3.0-beta see the issue tracker change log here



4.2.1 (4th March 2016)

This release includes changes to the DB Schema that is automatically installed when the app restarts only once and will not re-check, this is done by checking for a presence a simple marker file in the location /App_Data/TEMP/formsupdate after the install is run, it removes this marker file. This may be problematic when deploying to further environments if the marker file has been removed by the install process. To rectify this simply create the marker file in the location /App_Data/TEMP/formsupdate 

To verify the update process worked correctly, verify the following tables have been created in your database:

  • UFUserFormSecurity
  • UFUserSecurity


For a full list of changes in 4.2.1 see the issue tracker change log here


4.2.0 (2nd March 2016)
*Note: Unreleased due to bug in upgrade code - use version 4.2.1

This version includes the first large set of bug fixes and brings the ability to copy forms and reintroduce a feature that was in Contour; Form Security allowing you to control who has access to edit forms.

For a full list of changes in 4.2.0 see the issue tracker change log here


4.1.5 (26th Jan, 2016)

High priority security upgrade
All versions of Umbraco Forms are affected and you should upgrade immediately.


Package files

Archived files


 Download package
version 8.8.0

NuGet install instructions for Umbraco 7.1.0-8.17.0

Install-Package UmbracoForms

Package owner

Umbraco HQ

Umbraco HQ

Umbraco has 7852 karma points

Package Compatibility

This package is compatible with the following versions as reported by community members who have downloaded this package:
Works on Umbraco Cloud
Version 9.0.x (100%)
Version 8.17.x (untested)
Version 8.16.x (untested)
Version 8.15.x (untested)
Version 8.14.x (100%)
Version 8.13.x (100%)
Version 8.12.x (67%)
Version 8.11.x (100%)
Version 8.10.x (100%)
Version 8.9.x (100%)
Version 8.8.x (100%)
Version 8.7.x (100%)
Version 8.6.x (100%)
Version 8.5.x (100%)
Version 8.4.x (100%)
Version 8.3.x (100%)
Version 8.2.x (100%)
Version 8.1.x (100%)
Version 8.0.x (untested)
Version 7.15.x (100%)
Version 7.14.x (100%)
Version 7.13.x (100%)
Version 7.12.x (100%)
Version 7.11.x (100%)
Version 7.10.x (100%)
Version 7.9.x (100%)
Version 7.8.x (untested)
Version 7.7.x (100%)
Version 7.6.x (90%)
Version 7.5.x (80%)
Version 7.4.x (79%)
Version 7.3.x (67%)
Version 7.2.x (75%)
Version 7.1.x (33%)
Version 7.0.x (100%)

You must login before you can report on package compatibility.

Package Information

  • Package owner: Umbraco HQ
  • Created: 21/03/2010
  • Current version 8.8.0
  • .NET version 4.7.2,4.5
  • License Umbraco purchasing terms
  • Downloads on Our: 95.8K
  • Downloads on NuGet: 867.5K
  • Total downloads : 963.3K

External resources