> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-forms/developer/email-templates.md). # Email Templates Forms include **Send email with template (Razor)** Workflow. This allows you to pick a Razor view file that can be used to send out a *pretty HTML email* for Form submissions. ## Creating an Email Template To use custom templates with the **Send email with template (Razor)** workflow, place your files in the `~/Views/Partials/Forms/Emails/` folder. They will then appear as options in the dropdown menu. The Razor view must inherit from FormsHtmlModel: ```csharp @inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage ``` You now have a model with your Form fields. This can be used in your email HTML markup, along with the UmbracoHelper methods like `Umbraco.TypedContent` and `Umbraco.TypedMedia`, and so on. Below is an example of an email template based on `Example-Template.cshtml` shipped with Umbraco Forms. Use this as a base for creating your own template. {% hint style="warning" %} **Absolute URLs in load-balanced or proxied environments** The example below builds an absolute domain from `Context.Request.Scheme` and `Context.Request.Host`. This relies on the incoming request's `Host` header, which is fine when an email is rendered during a normal front-end form submission. It can produce empty or incorrect links when the email is generated **outside** of that request. Examples include re-running a workflow from the backoffice, or running it from a background or scheduled job. On a different node, or behind a load balancer or reverse proxy, the `Host` header may not match your site's public address. From Umbraco 17, the `Host` header is no longer used to auto-detect the application URL by default. In load-balanced, proxied, or multi-node setups, set the application URL explicitly. This ensures absolute links - including the `FormPageUrl` exposed on the email model - resolve consistently on every node: ```json { "Umbraco": { "CMS": { "WebRouting": { "UmbracoApplicationUrl": "https://www.your-site.com/" } } } } ``` See [Web Routing Settings](https://docs.umbraco.com/umbraco-cms/develop-with-umbraco/configuration/webroutingsettings) for details. When you need the public site URL inside a template, prefer reading it from this configuration (or `IHostingEnvironment.ApplicationMainUrl`) rather than from `Context.Request.Host`. {% endhint %} ```csharp @using Microsoft.AspNetCore.Html @using Umbraco.Forms.Core.Extensions @inherits Umbraco.Cms.Web.Common.Views.UmbracoViewPage @{ //This is an example email template where you can use Razor Views to send HTML emails //You can use Umbraco.Content & Umbraco.Media etc to use Images & content from your site //directly in your email templates too //Strongly Typed //@Model.GetValue("aliasFormField") //@foreach (var color in Model.GetValues("checkboxField")){} //Images need to be absolute - so fetching domain to prefix with images var siteDomain = Context.Request.Scheme + "://" + Context.Request.Host; var assetUrl = siteDomain + "/App_Plugins/UmbracoForms/assets/Email-Example"; }

Submission for @Model.FormName

@if (Model.HeaderHtml is not null) { } @if (Model.BodyHtml is not null) { } @if (Model.FooterHtml is not null) { }

@Model.HeaderHtml

@Model.BodyHtml

Form Results

@{ string[] ignoreFields = new string[] { "FieldType.Recaptcha2.cshtml", "FieldType.Recaptcha3.cshtml", "FieldType.RecaptchaEnterprise.cshtml", "FieldType.RichText.cshtml", "FieldType.Text.cshtml" }; } @foreach (var field in Model.Fields.Where(x => ignoreFields.Contains(x.FieldType) == false)) {

@field.Name

@switch (field.FieldType) { case "FieldType.FileUpload.cshtml": var uploadCount = 0; foreach (var fileUploadValue in field.GetValues()) { if (fileUploadValue != null && !string.IsNullOrEmpty(fileUploadValue.ToString())) { uploadCount++; } } if (uploadCount > 0) { @uploadCount file@(uploadCount == 1 ? string.Empty : "s") uploaded } break; case "FieldType.DatePicker.cshtml": var datePickerValue = field.GetValue(); if (datePickerValue != null && !string.IsNullOrEmpty(datePickerValue.ToString())) { DateTime dt; var dateValid = DateTime.TryParse(datePickerValue != null ? datePickerValue.ToString() : string.Empty, out dt); var dateStr = dateValid ? dt.ToString("f") : ""; @dateStr } break; default: var values = field.GetValues(); if (values != null) { foreach (var value in values) { if (value != null) { if (value is string strValue) { var captionedValue = strValue.ApplyPrevalueCaptions(field.Id, Model.PrevalueMaps); var encodedValue = System.Net.WebUtility.HtmlEncode(captionedValue); var processedValue = encodedValue.ReplaceLineEndings("
"); @Html.Raw(processedValue) } else { @value }
} } } break; }

}

@Model.FooterHtml

``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.umbraco.com/umbraco-forms/developer/email-templates.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.