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

Short answer
Additional Settings is a tab in every Contact Form 7 form where you add one-line settings that change that form's behavior. Common ones are demo_mode for testing, skip_mail to stop emails, subscribers_only for logged-in users, acceptance_as_validation and do_not_store. The old on_sent_ok setting is replaced by DOM events.
Key takeaways
- Find the box under Contact > Contact Forms > your form > Additional Settings.
- Write one setting per line in the format name: value.
- demo_mode sends nothing, so remove it before the form goes live.
- skip_mail stops email but still processes and stores submissions.
- subscribers_only limits a form to logged-in users of any role.
- on_sent_ok no longer works; use DOM events such as wpcf7mailsent instead.
What are Contact Form 7 additional settings?
Additional Settings is a tab in each Contact Form 7 form where you type short name: value lines that change how that form behaves, such as test mode, skipping email, or limiting the form to logged-in users.
Every form you create in Contact Form 7 has four tabs: Form, Mail, Messages and Additional Settings. The first three have visible fields. The last one is a plain text box.
That box accepts a small set of recognized settings, one per line. Contact Form 7 reads them when the form loads or is submitted, and changes its behavior for that form only.
This page explains what each setting does, when to use it, and which old settings no longer work. The official Additional Settings documentation is the reference if anything changes in a future release.
Where do you find the Additional Settings tab?
Go to Contact > Contact Forms, open the form you want to change, click the Additional Settings tab, type your settings one per line, and save the form.
Steps:
- In the dashboard, go to Contact > Contact Forms.
- Click the form title to edit it.
- Click the Additional Settings tab.
- Type each setting on its own line, such as demo_mode: on.
- Click Save.
Settings apply only to that form. If you want the same behavior on several forms, add the lines to each one.
The format is strict. Use the exact setting name, a colon, a space and the value. Misspelled names are simply ignored, so double-check your typing if something does not seem to work.
New to the plugin? Our guide on how to use Contact Form 7 covers the other tabs first.
What does each additional setting do?
The settings you will use most are demo_mode, skip_mail, subscribers_only, acceptance_as_validation and do_not_store, plus the Flamingo settings if you save submissions.
| Setting | Example | What it does |
|---|---|---|
| demo_mode | demo_mode: on | Form shows success but sends no mail and runs no other actions |
| skip_mail | skip_mail: on | Skips sending email but still processes the submission |
| subscribers_only | subscribers_only: true | Only logged-in users can see and submit the form |
| acceptance_as_validation | acceptance_as_validation: on | Treats unchecked acceptance boxes as a validation error |
| do_not_store | do_not_store: true | Tells storage add-ons such as Flamingo not to save the message |
| flamingo_email, flamingo_name, flamingo_subject | flamingo_subject: “[your-subject]” | Controls which fields Flamingo uses for email, name and subject |
Each is explained in more detail below.
What does demo_mode do?
With demo_mode set to on, the form behaves as if submissions succeed, but Contact Form 7 does not send mail or perform its usual actions, which makes it useful for testing layouts and messages.
Add this line:
demo_mode: on
Use it when you are designing a form, checking validation messages or showing a client how the form works, and you do not want test emails landing in an inbox.
Remember to remove it before going live. A form left in demo mode looks like it works, but every real enquiry is lost. That makes it one of the first things to check if you are investigating Contact Form 7 not sending email.
What does skip_mail do?
skip_mail: on stops Contact Form 7 from sending the notification email while still treating the submission as real, so storage add-ons and integrations can still receive the data.
Add this line:
skip_mail: on
This differs from demo mode. With skip_mail, the submission is still processed.
If you use Flamingo, the message is saved. If you have integrations that act on submissions, they can still run.
It suits forms where you only want submissions stored in the dashboard, or where another system handles notifications. If you do want email, set it up on the Mail tab instead, as covered in our guide to Contact Form 7 mail settings.
What does subscribers_only do?
subscribers_only: true hides the form from visitors who are not logged in and blocks their submissions, which suits member areas and internal request forms.
Add this line:
subscribers_only: true
Despite the name, any logged-in user can use the form, not just users with the Subscriber role. Logged-out visitors see a message instead of the form.
A side effect is useful: because only known users can submit, spam protection is less critical on these forms. Contact Form 7 may skip some spam checks for them, so make sure your membership signups themselves are protected.
What does acceptance_as_validation do?
By default an unticked acceptance checkbox disables the submit button; with acceptance_as_validation set to on, the form can be submitted and shows a validation error for the unticked box instead.
Add this line:
acceptance_as_validation: on
Acceptance checkboxes are used for consent statements, such as agreeing to a privacy policy. The default behavior can confuse visitors, because a greyed-out button gives no clear reason why.
With this setting, visitors get a clear error message next to the checkbox. Many site owners find that friendlier. You can edit the message text on the Messages tab.
This is general information about form behavior, not legal advice. If you collect consent for legal reasons, check what your local rules require for wording and records.
What do do_not_store and the Flamingo settings do?
do_not_store: true tells storage plugins not to save messages from that form, while flamingo_email, flamingo_name and flamingo_subject tell Flamingo which fields to use when it saves a message.
Flamingo is the companion plugin from the Contact Form 7 author that stores submissions in the dashboard. Our guide on how to see Contact Form 7 submissions explains how to set it up.
By default, Flamingo looks for fields named your-email, your-name and your-subject. If your form uses different names, map them:
flamingo_email: “[client-email]”
flamingo_name: “[client-name]”
flamingo_subject: “Quote request from [client-name]”
Use do_not_store: true for forms that handle sensitive data you do not want kept in the database, such as health or financial details. The Flamingo documentation covers storage in more depth.
What happened to on_sent_ok and on_submit?
The old on_sent_ok and on_submit settings ran JavaScript after a submission, but they were deprecated in Contact Form 7 5.0 and removed, so you now use DOM events instead.
Older tutorials often show lines like on_sent_ok: “location = '/thank-you/';” for redirects or analytics tracking. These no longer work on current versions.
The replacement is to listen for Contact Form 7's DOM events in your own JavaScript. For example, the wpcf7mailsent event fires after mail is sent successfully:
document.addEventListener( 'wpcf7mailsent', function ( event ) {
window.location.href = '/thank-you/';
}, false );
Add this through a code snippets plugin or your theme's scripts, not the Additional Settings box. MDN explains addEventListener if you are new to event listeners.
You can check the event's detail to run code only for a specific form ID. That keeps a thank-you redirect from firing on every form on your site.
What are the most common mistakes with additional settings?
The usual mistakes are leaving demo_mode on, mistyping a setting name, adding settings to the wrong form, and copying old on_sent_ok code that no longer works.
Quick checks when something does not behave as expected:
- Is demo_mode still on? Remove it before launch.
- Is the spelling exact? Names use underscores and lowercase.
- Is it the right form? Settings do not carry across forms.
- Is the value right? Use the value shown in the documentation, such as on or true.
- Is caching serving an old form? Clear your cache after saving.
If Contact Form 7 shows a warning at the top of the form editor, read it. Our guide on the Contact Form 7 configuration error explains common warnings.
Are there settings outside the Additional Settings box?
Yes; a few site-wide options are set with PHP constants in wp-config.php, such as turning off automatic paragraph tags, and these affect every form rather than one.
For example, Contact Form 7 respects constants that control automatic paragraph formatting and some loading behavior. These go in the wp-config.php file, above the line that tells you to stop editing.
Only use them if you understand the effect, and back up wp-config.php before editing. Styling changes are better handled with CSS, as shown in our guide on how to style Contact Form 7.
Frequently asked questions
What is the difference between demo_mode and skip_mail?
Demo mode makes the form look successful without sending mail or running its usual actions, so it is for testing. Skip mail stops only the email, while the submission is still processed, so storage plugins like Flamingo and other integrations can still receive the data.
How do I redirect to a thank-you page in Contact Form 7?
Use JavaScript that listens for the wpcf7mailsent DOM event and then changes the page location. Add the code with a snippets plugin or your theme's scripts. The old on_sent_ok additional setting no longer works in current versions of the plugin.
Do additional settings apply to all forms?
No. Each form has its own Additional Settings box, and lines there only affect that form. To apply the same setting to several forms, add the line to each form separately. Site-wide behavior is controlled with constants in wp-config.php instead.
Why is my Contact Form 7 form not sending email after setup?
Check whether demo_mode or skip_mail is in the Additional Settings box, because both stop emails. If they are not there, check the Mail tab settings and consider using an SMTP plugin, since many servers do not deliver mail sent with the default method.
Can I hide a Contact Form 7 form from logged-out visitors?
Yes. Add subscribers_only: true to the form's Additional Settings. Logged-out visitors will see a message instead of the form, and only logged-in users of any role can submit it. This suits member areas and internal request forms.
Sources
- Additional settings Contact Form 7
- DOM events Contact Form 7
- Save submitted messages with Flamingo Contact Form 7
- Contact Form 7 WordPress.org
- Flamingo WordPress.org
- EventTarget: addEventListener() method MDN Web Docs
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.


