Early Black Friday: Divi Doctor Lifetime for $129 (unlimited sites). Ends Cyber Monday. 14-day money-back guarantee.

Email subject, HTML email and confirmation email

Divi’s Contact Form sends you a plain-text email with a fixed subject, and the visitor gets nothing back. Divi Doctor adds three options you can switch on separately: your own email subject, an HTML email written in a rich-text editor, and a confirmation email to the visitor.

Setting a custom subject, formatting the Message Pattern and switching on the confirmation email, then the emails that arrive.

Switch the options on

  1. Go to Divi Doctor → Features.
  2. Under Contact Form module, click Enable on the cards you want: Custom email subject, HTML email and Message Pattern editor and Confirmation email to the sender.

Each switch adds options to the Divi 5 Contact Form module in the Visual Builder. A form uses them only when you set them on that form. They change only Divi’s own email for that form, and only after the form has passed Divi’s checks; email sent by other plugins is never touched.

Divi Doctor → Features: enable Custom email subject, HTML email and Confirmation email.

Custom email subject

Divi titles every email “New Message From” followed by your site title, plus the form title when the form has one. With this option on, open the form’s Content → Email group. A Subject field sits right after Email Address. Type your subject, for example New enquiry from %%name%%, and save. Leave it empty to keep Divi’s subject.

The Subject field, with placeholders such as %%name%%.

Placeholders

PlaceholderReplaced with
%%field_id%%What the visitor entered in the field with that Field ID, for example %%name%%, %%email%% or %%message%%.
%%site_title%%Your site title from Settings → General.
%%form_title%%The Contact Form’s title.

The same placeholders work in the HTML Message Pattern and in the confirmation email. A few rules apply:

  • A placeholder with no value, such as a field the visitor left empty, is removed.
  • Text a visitor types is never treated as a placeholder, so typing %%email%% into a field doesn’t insert anything.
  • A subject is always one line: line breaks and extra spaces are collapsed, and it’s cut at 250 characters. Visitors can’t add mail headers through it.

HTML email and the Message Pattern editor

With this option on, Content → Email → Message Pattern uses Divi’s rich-text editor, the same one as the Text module. Format your notification with bold labels, links or lists and save. A pattern with any formatting is sent as an HTML email, with a plain-text version included for mail apps that can’t show HTML.

  • An empty pattern, or one without any formatting, is sent by Divi exactly as before, as plain text.
  • %%field_id%%, %%site_title%% and %%form_title%% work as in the subject. Line breaks the visitor typed are kept.
  • Divi’s {{if:field_id}}…{{/if}} blocks work as usual: the text inside shows only when that field was sent, for example when conditional logic didn’t hide it.
  • Everything the visitor typed is inserted as plain text, so visitors can’t add HTML or links to your email. The pattern itself is limited to the HTML WordPress allows in posts.
  • Empty paragraphs are removed, and the email is wrapped in a simple layout with a white background and a maximum width of 640 pixels.

Dynamic content in the pattern isn’t resolved; Divi doesn’t resolve it there either.

Note: If you turn the HTML email option off later, a pattern saved with formatting is sent as readable plain text while Divi Doctor is active. If you deactivate Divi Doctor, Divi sends such a pattern with its HTML tags showing, so edit those forms’ Message Pattern first.

The Message Pattern with a full editor, sent as an HTML email.

Confirmation email

With this option on, each Contact Form has a Confirmation Email group in its Content tab. Switch on Send Confirmation Email and the visitor gets an email right after their message was sent. A subject and message are filled in for you; change them or keep them.

OptionWhat it doesDefault
Send Confirmation EmailEmails the visitor after their message was sent. It goes to the address in the field with the Field ID email.Off
SubjectThe confirmation’s subject, with placeholders.We received your message - %%site_title%%
MessageThe confirmation’s text, in Divi’s rich-text editor, with placeholders and {{if:field_id}}…{{/if}} blocks.“Hi %%name%%,” / “Thank you for getting in touch. We have received your message and will reply as soon as we can.” / “%%site_title%%”
Include A Copy Of The MessageAdds a table headed “A copy of your message” below your text, with every field the visitor filled in.Off

How the confirmation is sent:

  • Only after Divi’s own email went out. It’s never sent when the form fails a required field, the captcha or the spam check, or when Divi’s email fails.
  • Only to a single valid address. A form without a field with the ID email can’t send a confirmation.
  • From shows your site title, with WordPress’s default sending address. An SMTP or mail plugin that sets its own sender address still does so.
  • Reply-To is the first valid address in the form’s Email Address setting (or the site admin email), so when the visitor replies, the reply reaches you.
  • It’s sent as HTML with a plain-text version. Where your server allows it, it goes out after the visitor’s page has loaded, so they don’t wait for it.
Send Confirmation Email, with a ready subject and message.

Turn on a spam protection service

A confirmation email goes to whatever address someone types into your form. Without protection, a bot could use your form to send its own text to other people. Divi’s basic captcha can be answered by a bot, so Divi Doctor checks whether the form uses Content → Spam Protection → Use A Spam Protection Service.

Until that is on for the form, the confirmation uses only your own text:

  • Every placeholder except %%site_title%% and %%form_title%% is left out, so “Hi %%name%%,” reads “Hi,”.
  • {{if:field_id}}…{{/if}} blocks are left out.
  • Include A Copy Of The Message is ignored.

The builder shows a warning about this in the Confirmation Email group, and the log on the feature card notes each time something was left out. Your own notification email isn’t affected.

Turn on a spam protection service so the confirmation can include a copy of the message.

Hourly limits

To stop the form being used to send mail to other people, confirmations are limited per clock hour:

  • 3 to any one email address
  • 10 triggered by any one visitor (by IP address)
  • 30 across the whole site

Each limit counts within a fixed clock hour and starts again when the next hour begins. When a limit is reached, the confirmation is skipped and logged as Skipped: hourly limit reached. The visitor’s message and your notification are sent as usual.

Logs on the feature card

The Confirmation email to the sender card in Divi Doctor → Features shows the hourly limits and the last confirmation. Open Recent confirmation emails to see the last 30, with these columns:

  • When and Result (Sent or Not sent)
  • To: the address, masked, for example ja***@example.com
  • Page: the page the form was sent from
  • Details: Sent., the hourly-limit message, or WordPress could not send the email (wp_mail() returned false)., plus a note when visitor values or the copy were left out

Click Clear log to empty the list. The subject and HTML email options have no log; their cards show whether they’re on.

What arrives: your notification, and the visitor’s confirmation.

Limits

  • These options work with the Divi 5 Contact Form module only.
  • A mail plugin that replaces WordPress’s wp_mail() function without running its wp_mail filter keeps Divi’s subject and plain-text body. Confirmations are then skipped too, because Divi Doctor can’t see that Divi’s email went out.
  • Your mail server’s sending limits still apply.

To add the visitor to a mailing list as well, see Mailchimp for the Contact Form.

For developers

  • ddoc_cf_confirmation_limits: the hourly limits, as [ 'recipient' => 3, 'ip' => 10, 'site' => 30 ]. Each value is at least 1.
  • ddoc_client_ip: the visitor IP used for the per-visitor limit. By default it is the connection address (REMOTE_ADDR). Behind a proxy, return the real address, taken only from a header your proxy overwrites.

Questions

Can I change the subject of Divi Contact Form emails?

Yes, with Divi Doctor Pro. Enable Custom email subject, then type your subject in the Subject field of the form’s Content → Email group, for example New enquiry from %%name%%. Leave it empty to keep Divi’s subject, “New Message From” followed by your site title.

Can the Divi Contact Form send HTML emails?

Yes. With HTML email and Message Pattern editor on, the Message Pattern uses Divi’s rich-text editor. A pattern with any formatting is sent as an HTML email, with a plain-text version included for mail apps that can’t show HTML.

Can the Divi Contact Form send a confirmation email to the visitor?

Yes. Enable Confirmation email to the sender, then switch on Send Confirmation Email in the form’s Confirmation Email group. The visitor gets an email right after their message was sent, at the address in the field with the Field ID email.

Which placeholders can I use in the subject and the message?

%%field_id%% for what the visitor entered in the field with that Field ID, for example %%name%%, %%email%% or %%message%%, plus %%site_title%% and %%form_title%%. A placeholder with no value is removed.

Why is no confirmation email sent?

The confirmation is sent only after Divi’s own email went out, and only to a single valid address. A form without a field with the ID email can’t send one. It is never sent when the form fails a required field, the captcha or the spam check, or when Divi’s email fails.

Where does the reply go when a visitor answers the confirmation email?

To you. Reply-To is the first valid address in the form’s Email Address setting, or the site admin email.

Can the confirmation email include a copy of the visitor’s message?

Yes. Switch on Include A Copy Of The Message. It adds a table headed “A copy of your message” below your text, with every field the visitor filled in.

What happens to formatted message patterns if I deactivate Divi Doctor?

Divi then sends such a pattern with its HTML tags showing, so edit those forms’ Message Pattern first. While Divi Doctor is active and the HTML email option is off, a pattern saved with formatting is sent as readable plain text.