Merge pull request #6748 from umbraco/forms/remove-default-email-template

Added details on removing built-in email templates

Author: sofietoft

13/umbraco-forms/developer/themes.md

@@ -113,6 +113,21 @@ public class MyComposer : IComposer
 }
 ```
 
+##### Removing the Default Email Template
+
+If providing custom email templates, you may want to remove the one provided with Forms. You can do that via the same `EmailTemplates` collection.
+
+```csharp
+public class MyComposer : IComposer
+{
+    public void Compose(IUmbracoBuilder builder)
+    {
+      builder.EmailTemplates()
+          .Exclude<DefaultEmailTemplate>();
+    }
+}
+```
+
 ## Using a Theme
 
 To use a theme with a Form use the "Insert Form" macro where you will be presented with the options of the form you wish to insert along with an option to pick a theme. This displays the list of theme folders found at `Views/Partials/Forms/Themes`.

14/umbraco-forms/developer/themes.md

@@ -114,6 +114,21 @@ public class MyComposer : IComposer
 }
 ```
 
+##### Removing the Default Email Template
+
+If providing custom email templates, you may want to remove the one provided with Forms. You can do that via the same `EmailTemplates` collection.
+
+```csharp
+public class MyComposer : IComposer
+{
+    public void Compose(IUmbracoBuilder builder)
+    {
+      builder.EmailTemplates()
+          .Exclude<DefaultEmailTemplate>();
+    }
+}
+```
+
 ## Using a Theme
 
 When rendering a form in a view file, you can specify which theme to use with the form.

15/umbraco-forms/developer/themes.md

@@ -114,6 +114,21 @@ public class MyComposer : IComposer
 }
 ```
 
+##### Removing the Default Email Template
+
+If providing custom email templates, you may want to remove the one provided with Forms. You can do that via the same `EmailTemplates` collection.
+
+```csharp
+public class MyComposer : IComposer
+{
+    public void Compose(IUmbracoBuilder builder)
+    {
+      builder.EmailTemplates()
+          .Exclude<DefaultEmailTemplate>();
+    }
+}
+```
+
 ## Using a Theme
 
 When rendering a form in a view file, you can specify which theme to use with the form.

15/umbraco-forms/upgrading/version-specific.md

@@ -26,7 +26,7 @@ For reference, the full details are listed here:
 
 * The setting `FieldSettings:Recaptcha3:ShowFieldValidation` has a new default of `true`.
 * The setting `Options:EnableMultiPageFormSettings` has a new default of `true`.
-* The setting `FormDesign:RemoveProvidedEmailTemplate` has been removed (as adding and removing email templates can be more consistently handled using `EmailTemplateCollection`).
+* The setting `FormDesign:RemoveProvidedEmailTemplate` has been removed (as adding and removing email templates can be more consistently handled using [`EmailTemplateCollection`](../developer/themes.md#removing-the-default-email-template)).
 
 #### **Asynchronous Methods**