Plugin how-tos · Info
Contact Form 7 Mail Settings Explained: What Each Option Does

Short answer
Contact Form 7 mail settings sit on each form's Mail tab. To sets the recipient, From sets the sender, Subject and Message Body use mail-tags for visitor answers, Additional Headers adds Reply-To, Cc or Bcc, and Mail (2) sends an optional autoresponder.
Key takeaways
- Each form has its own Mail tab with separate settings.
- Keep the From address on your own website domain.
- Use a Reply-To header to answer visitors directly.
- Mail-tags in the body must match field names on the Form tab.
- Mail (2) is an optional second email, often an autoresponder.
- Delivery problems usually need SMTP, not different mail settings.
What are the Contact Form 7 mail settings?
The mail settings live on the Mail tab of each form and control who receives a submission, who it appears to come from, the subject, the message body and any attachments.
Every Contact Form 7 form has four tabs: Form, Mail, Messages and Additional Settings. The Mail tab is the one that decides what email gets sent when someone presses Submit.
Each form has its own Mail tab. If you have a contact form and a quote form, you set up mail separately for both.
If you are still building your first form, our guide on how to use Contact Form 7 covers the Form tab and shortcode first. This article focuses only on the mail options.
What does each field on the Mail tab do?
The Mail tab has fields for To, From, Subject, Additional Headers, Message Body and File Attachments, plus a few checkboxes that change how the body is built.
Here is a quick summary before we look at each one.
| Field | What it controls | Typical value |
|---|---|---|
| To | Who receives the email | Your admin or team address |
| From | The sender shown in the inbox | Site name with an address on your domain |
| Subject | The email subject line | Site title plus the visitor's subject |
| Additional Headers | Extra headers like Reply-To, Cc, Bcc | Reply-To set to the visitor's email |
| Message Body | The content of the email | Mail-tags for each form field |
| File Attachments | Files uploaded through the form | The file field's mail-tag |
The official Setting Up Mail guide on the plugin's site describes these fields and shows the default template.
What should you put in the To field?
The To field holds the address that receives each submission, usually your own inbox or a shared team address.
By default, Contact Form 7 fills this with the special mail-tag for the site admin email. That is the address set under Settings and then General in WordPress.
You can type a fixed address instead, such as a sales or support mailbox. Separate several addresses with commas if more than one person should get every message.
You can also use a mail-tag here. For example, a select menu that lets visitors pick a department can route the email to different addresses, though this needs a little extra setup with pipes in the form field.
What should the From field contain?
The From field should use an email address on your own website's domain, with your site name in front, so mail servers trust the message.
This is the most misunderstood setting. Many people put the visitor's email in the From field because they want to reply to it directly.
That breaks email authentication. Your server is not allowed to send mail as a Gmail or Outlook user, so the message often lands in spam or is rejected.
The plugin's configuration validator warns you when the From address does not belong to your site's domain. Contact Form 7 explains this in its best practice for mail setup.
A safe From value looks like this, using your own domain:
My Site <[email protected]>
If messages still do not arrive, set up proper sending with SPF and DKIM records. Our guide on setting up SPF, DKIM and DMARC for WordPress explains the DNS side.
How does the Subject field work?
The Subject field sets the email subject line and can mix fixed text with mail-tags, such as your site title and the subject the visitor typed.
The default subject combines the site title with the visitor's subject field. That makes it easy to spot form emails in a busy inbox.
You can change it to anything useful, like New quote request from [your-name]. Just make sure every mail-tag you use matches a field name in your form.
What are Additional Headers used for?
Additional Headers add extra email headers, most often Reply-To so you can answer the visitor directly, plus Cc and Bcc for copies.
The default template includes a Reply-To header with the visitor's email mail-tag. That is the right way to reply to the person without putting their address in From.
You can add one header per line:
Reply-To: [your-email]
Cc: [email protected]
Bcc: [email protected]
The plugin documents this in its guide to adding Cc, Bcc and other mail headers.
Header names must be spelled correctly and followed by a colon. A typo here can stop the email from sending or cause the header to be ignored.
What goes in the Message Body?
The Message Body is the email content, built from plain text and mail-tags that are replaced with whatever the visitor entered in each field.
A mail-tag is the field name in square brackets. If your form has a field called your-phone, then [your-phone] in the body becomes the phone number the visitor typed.
The Mail tab lists all available mail-tags above the fields. Tags shown there come from the fields in your form, so add the field on the Form tab first.
Contact Form 7 also offers special mail-tags that are not tied to a form field. Examples include the page URL, the submission date and time, the site title and the visitor's IP address.
These are handy for spotting which page a message came from. Be careful with personal data such as IP addresses if you have privacy obligations.
What do the body checkboxes do?
Below the Message Body you will find options to skip lines with empty mail-tags and to send the email as HTML instead of plain text.
Exclude lines with blank mail-tags from output removes any line where the visitor left that field empty. It keeps emails tidy when your form has many optional fields.
Use HTML content type sends the message as HTML. You can then use simple HTML tags in the body for bold labels, line breaks or a small table.
Plain text is more reliable for most sites. Switch to HTML only if you want formatting and you test the result in a few email clients.
How do file attachments work?
To attach uploaded files, add a file upload field on the Form tab, then put that field's mail-tag in the File Attachments box on the Mail tab.
For example, a field named your-file needs [your-file] in File Attachments. Without that, the visitor can upload a file but it never reaches your inbox.
You can also attach a fixed file from your server, such as a brochure, by entering its path relative to the content folder.
Large attachments may be blocked by your mail server. Set a sensible size limit on the file field to avoid failed emails.
What is Mail (2)?
Mail (2) is an optional second email template, usually used as an autoresponder that sends the visitor a copy or a thank-you note.
Tick Use Mail (2) on the Mail tab to show its fields. They work the same as the first template, but you will usually set To to the visitor's email mail-tag.
Keep the From address on your own domain here too. Write a short confirmation message and avoid repeating sensitive details back to the visitor.
Spammers sometimes abuse autoresponders to send junk through your site. Our guide on stopping contact form spam covers reCAPTCHA, Akismet and other protection.
Which related settings live outside the Mail tab?
The Messages tab controls the text visitors see after submitting, and the Additional Settings tab can change sending behavior, such as skipping mail entirely.
On the Messages tab, you can edit the success and failure notices. That is where the There was an error trying to send your message text comes from.
In Additional Settings, skip_mail: on stops the form from sending any email. demo_mode: on does the same and is meant for testing. Check this tab if mail suddenly stops working.
Contact Form 7 does not store submissions by default. If you want a record, see our guide on how to see Contact Form 7 submissions.
What should you check if mail settings look right but nothing arrives?
If every field looks correct but emails do not arrive, the problem is usually delivery, so send mail through an SMTP service instead of the server's default mail function.
WordPress sends mail through the wp_mail() function, which uses the PHPMailer library and, by default, PHP's built-in mail() function by default, and many hosts handle that poorly. An SMTP plugin connects your site to a proper email service.
Our walkthrough on setting up SMTP in WordPress covers the common providers.
For form-specific checks, see why Contact Form 7 is not sending.
You can see the plugin's own listing and support forum on the Contact Form 7 plugin page at WordPress.org.
Frequently asked questions
Where are the mail settings in Contact Form 7?
Go to Contact and then Contact Forms in your dashboard, open the form you want to edit, and click the Mail tab. Every form has its own Mail tab, so changes there only affect that one form and not the rest of your forms.
Should I use the visitor's email in the From field?
No. Putting the visitor's address in From makes your server pretend to be their email provider, which fails authentication checks and often sends mail to spam. Use an address on your own domain in From and put the visitor's email in a Reply-To header instead.
How do I send Contact Form 7 emails to multiple people?
Enter several addresses in the To field separated by commas. You can also add Cc or Bcc lines in the Additional Headers box, one per line. Each recipient then gets a copy of every submission sent through that form.
What is the difference between Mail and Mail (2)?
Mail is the main email sent to you or your team when a form is submitted. Mail (2) is an optional second template you switch on with a checkbox. It is usually set up as an autoresponder that sends the visitor a confirmation or copy of their message.
Why are my Contact Form 7 mail-tags not replaced?
The tag name probably does not match a field name on the Form tab. Mail-tags are case-sensitive and must use the exact field name in square brackets. Check the list of available mail-tags shown above the Mail tab fields and copy names from there.
Sources
- Setting Up Mail Contact Form 7
- Best Practice to Set Up Mail Contact Form 7
- Special Mail-tags Contact Form 7
- Adding Cc, Bcc and Other Mail Headers Contact Form 7
- Contact Form 7 plugin WordPress.org
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


