Notifications

Email notifications send emails after a form is submitted. FormBuilder supports multiple email notification templates, such as administrator notifications, submitter confirmations, and payment notifications.

Prerequisite: Configure the SMTP Server

FormBuilder's email notifications rely on the DNN platform's email functionality. First ensure the SMTP server is configured in DNN, otherwise all email notifications (admin notifications, user confirmations, payment notifications, etc.) cannot be sent.

DNN supports two levels of SMTP configuration:

• Host level (global): Host → Host Settings → Advanced Configuration → SMTP Server Settings Default SMTP settings applied to all sites
• Site level (single site): Admin → Site Settings → Advanced Settings → SMTP Server Settings Switch the SMTP mode to Portal to enable site-specific configuration, which overrides the Host level settings

After configuration, click Test SMTP on the page to verify the connection. Also ensure the site Administrator account's email address is valid and accepted by the SMTP server, since DNN uses this account as the sender by default.

📖 Official documentation: Setting the SMTP Server and Port

Notification List

Notifications are managed in a table; by default it includes an Admin notification:

Column	Description
Name	Notification name (e.g. Admin notification)
Mail Subject	Email subject (default: New submission from [Form#Name])
Status	Enable/Disable toggle
Actions	Edit, Duplicate, Remove

Click the Add Notification button to add a new email notification template.

Notification Template Settings

Click a notification's Edit button to open its settings.

Name (Required)

The name of the notification template. It is only displayed in the admin backend and does not appear in the email.

Status

Enable or disable this email notification.

Mail Type

The event type that triggers this email notification. Options:

Type	Description
Submit Notification (default)	Sent when the form is submitted
Payment Notification	Sent when payment is completed
Edit Notification	Sent when a user edits the submitted data

Choosing a Mail Type

• Submit Notification: Regular submission notification (most commonly used)
• Payment Notification: Send a confirmation email after a successful payment on an e-commerce form
• Edit Notification: Use together with Allow edit in General to notify the administrator when a user modifies a submission

Mail Subject (Required)

The email subject. Dynamically insert data into the subject via the Insert variable button.

Message (HTML) (Required)

Use the Jodit rich text editor to set the email body. The default content is [Record#AllData] (displays all submitted data). Insert variables via the Insert variable button.

Recipient

Recipient Toggle

When enabled, you can set detailed recipient information. When disabled, the default recipient is used.

Recipient Types

After enabling Recipient, you can set four recipient fields, each accepting direct email entry or variable insertion:

Field	Description
To	Primary recipient (placeholder hint: Email address)
Cc	Carbon copy recipient
Bcc	Blind carbon copy recipient
Reply-To	Reply address

Send to the Submitter

To send the email to the form submitter, click Insert variable in the To field and select the Email field under Submitted Form Value. The email entered by the user is automatically used as the recipient.

Separate multiple emails with a semicolon (;), for example: dnnskindev@gmail.com;admin@dnngo.net

Conditional Recipients

When enabled, you can dynamically set recipients based on form field conditions. Each conditional recipient rule is a card containing two parts: a recipient list and trigger conditions.

Add a Conditional Recipient

Click Add Conditional Recipients to add a conditional recipient card.

Card Structure

Each conditional recipient card contains:

1. Recipient List

Add recipients via the Add recipient button; each row contains:

Field	Description
Type	Recipient type: To (primary) / Cc (carbon copy) / Bcc (blind carbon copy) / Reply (reply address)
Email address	Email address, entered directly or inserted as a variable via Insert variable

Each recipient can be deleted individually, or new rows can be added.

2. Trigger Condition (Logic Rule)

In the condition area at the bottom of the card, set when this group of recipients is triggered:

• Select a target field from the drop-down list (shows the field's Label)
• Select an operator (is / is not / is empty / is not empty)
• Set the match value

Add multiple conditions via the Add logic rule button.

3. Card Actions

The top-right corner of each card provides:

• 🗑 (Delete): Delete the entire conditional recipient card
• 📄 (Duplicate): Duplicate this conditional recipient card

Use Cases

• Multi-department contact form: Create multiple conditional recipient cards. When the user selects "Sales", the email goes to the sales department; when "Technical Support" is selected, it goes to the technical department
• Regional assignment: Based on the user's region, send the email to the corresponding regional manager
• VIP customers: When the customer type is VIP, additionally cc a senior manager

Regular vs Conditional Recipients

• Regular Recipient: Fixed recipient, sent to the same address for every submission
• Conditional Recipients: Dynamic recipients, decided based on what the user entered

The two can be used together: set the regular Recipient to the administrator (always received), and Conditional Recipients to route to different departments based on conditions.

Attachments

When enabled, files uploaded via the File upload element in the form are sent as attachments with the email.

Using Variables

The email subject, content, and recipient fields all support inserting dynamic data via the Insert variable button. Variables are divided into three main categories (the Payment Notification type also adds an Order category):

Form Information

Variable	Description
[Form#Id]	Form ID
[Form#Name]	Form name

Record Information

Variable	Description
[Record#AllData]	All submitted data
[Record#FormUrl]	Form page URL
[Record#ReferringUrl]	Referring page URL
[Record#UserAgent]	User browser information
[Record#IpAddress]	User IP address
[Record#TimeZone]	Site time zone

Order Information

When Mail Type is set to Payment Notification, the following order variables can be used:

Variable	Description
[Order#OrderNumber]	Order number
[Order#StatusText]	Order status
[Order#PaymentStatusText]	Payment status
[Order#PaymentMethodText]	Payment method
[Order#TotalQuantity]	Total quantity
[Order#SubTotalAmount]	Subtotal amount
[Order#ShippingAmount]	Shipping amount
[Order#DiscountAmount]	Discount amount
[Order#TotalAmount]	Total amount
[Order#PaidAmount]	Amount paid
[Order#CurrencyCode]	Currency code
[Order#CurrencySymbol]	Currency symbol
[Order#LastPaymentTime]	Payment time
[Order#CreatedTime]	Order creation time
[Order#ItemsTable]	Order items table
[Order#CheckoutUrl]	Checkout page URL

Submitted Form Value

Lists all submittable elements in the form, shown by the field's Unique Name, using the [Element#UniqueName] format. For example:

Variable	Description
[Element#Name]	Value of the Name field
[Element#Email]	Value of the Email field
[Element#Subject]	Value of the Subject field
[Element#Messages]	Value of the Messages field

How to Insert a Variable

1. Click the Insert variable button on the right side of the input box (or the more icon)
2. Select a variable category from the pop-up menu (Form / Record / Order / Submitted Form Value)
3. Click the variable you need; it is automatically inserted at the cursor position

There is no need to manually type variable names; all variables can be selected via the menu.

Email Template Examples

We provide 4 common email template examples that you can copy and use directly:

Template	Mail Type	Recipient	Purpose
Form Submission Notification	Submit Notification	Administrator	Notify the administrator after a form is submitted
Form Submission Confirmation	Submit Notification	User Email	Send a confirmation to the user after submission
Payment Notification	Payment Notification	Administrator	Notify the administrator after a successful payment
Payment Confirmation	Payment Notification	User Email	Send a confirmation to the user after a successful payment

See the Email Template Examples page for details.

Next Steps

• Email Template Examples — Ready-to-copy email templates
• Confirmations — Post-submission confirmation messages
• Form Settings Overview — View all setting categories