Developer documentation

    Developer documentation covers working with Umbraco Forms from a developer standpoint. It covers retrieving data, it shows how to extend the system by hooking into the provider model, and finally it describes the available events and workflows you can use to extend or integrate Umbraco Forms.

    Preparing your Frontend

    Before adding a form to your site we'll need to make sure you have the necessary client dependencies.

    Custom markup

    Version 4.x - Write your forms your way. You have full control over your form's HTML markup and styling.

    Rendering Forms scripts where you want

    Version 4.x - Control where you want Forms to render its JavaScript.


    Version 6.0.0+ - Easier & more control of rendering Form HTML markup and styling using Themes that replaces the previous methods in Version 4.x

    Creating custom HTML emails

    Version 6.0.0+ - Send custom HTML email templates using the new workflow 'Send email with template (Razor)'.

    Working with Record data

    See how you can fetch and display record data from your Razor macros.


    Learn how you can extend Umbraco Forms with your own custom providers.


    Learn about some of the configuration options that are available to you to modify how Umbraco Forms works.

    Field Types

    Learn about the default Field Types that are shipped with Umbraco Forms and any specific details regarding how these work.

    Magic strings

    Learn about the magic string formats that Umbraco Forms supports, that can retrieve information from various sources such as Session, Cookies, Umbraco Page Fields, Member fields, Form fields to use in workflows.

    Storing Form Files with IFileSystem

    Version 4.4.0+ - Learn how you can implement a custom IFileSystem to store the Forms, Workflows, PreValues and other JSON-based files to suit your needs.