Troubleshooting
Checkboxes Not Appearing in Contact Form 7: A Simple Guide

Short answer
Contact Form 7 checkboxes usually disappear because your theme's CSS hides checkbox inputs, the form-tag is missing a name or options, or a cache still shows the old form. Inspect the form first, then restore the boxes with CSS or correct the tag syntax.
Key takeaways
- Inspect the form to see if the checkbox HTML is present.
- Theme CSS hiding inputs is the most common cause.
- A checkbox tag needs a name and quoted options.
- Curly quotes from copied text break form-tags.
- Mail tags must match the checkbox field name.
Why are checkboxes not appearing in Contact Form 7?
Contact Form 7 checkboxes usually go missing because the theme's CSS hides checkbox inputs, the form-tag has no options or a syntax error, or a cached copy of the old form is still showing.
The quickest way to tell which is happening is to view the page source or inspect the form. If the checkbox HTML is there, it is a styling problem. If it is not there, the form-tag or the shortcode is the problem.
Most cases take only a few minutes to fix once you know which side the fault is on.
| What you see | Likely cause | Fix |
|---|---|---|
| Labels show, boxes do not | Theme CSS hides the input | Add CSS to restore the checkbox |
| Nothing shows at all | Tag has no options or a typo | Correct the form-tag syntax |
| Raw tag text appears | Curly quotes or broken brackets | Retype the tag with straight quotes |
| Old form still showing | Page or plugin cache | Clear caches |
| Form not updated on page | Wrong form shortcode | Copy the shortcode again |
| Boxes look odd or tiny | Styling plugin or builder CSS | Check builder and plugin styles |
How do you check whether the checkbox is in the HTML?
Right-click where the checkbox should be, choose Inspect, and look for an input with type checkbox inside a span with the class wpcf7-list-item.
If you find the input but cannot see it on the page, the markup is fine and CSS is hiding it. Look at the Styles panel in the developer tools for rules like display: none, opacity: 0 or appearance: none.
If there is no checkbox input at all, Contact Form 7 did not output one. That points to the form-tag, the shortcode or a plugin conflict.
The MDN reference for the checkbox input explains the standard markup, which helps when you are reading the inspector.
Is your theme's CSS hiding the checkboxes?
Yes, this is the most common cause, because many themes restyle form inputs and some hide the native checkbox while expecting their own markup that Contact Form 7 does not use.
Themes built for a specific form plugin or a page builder sometimes include rules that hide every checkbox and replace it with a styled box. Contact Form 7's markup does not match, so the box simply disappears.
Add a CSS rule that targets only Contact Form 7 checkboxes and restores them. Place it under Appearance, Customize, Additional CSS, or in the Site Editor's custom CSS:
.wpcf7-form input[type="checkbox"],
.wpcf7-form input[type="radio"] {
display: inline-block;
opacity: 1;
position: static;
width: auto;
height: auto;
-webkit-appearance: checkbox;
appearance: auto;
}
The MDN page on the appearance property explains why appearance: none removes the native look.
Clear your caches after adding the rule. If the change does not show, our guide on CSS changes not showing covers cache and specificity issues.
Is the checkbox form-tag written correctly?
A checkbox form-tag needs a name and at least one option in straight double quotes, such as [checkbox your-interest "Design" "Hosting"], or nothing will render.
The Contact Form 7 guide to checkboxes, radio buttons and menus shows the full syntax. Here are some working examples:
[checkbox your-interest "Design" "Hosting" "SEO"]
[checkbox* your-services use_label_element "Web design" "Maintenance"]
[checkbox newsletter exclusive "Yes" "No"]
The asterisk makes the field required. The use_label_element option wraps each choice in a label, so visitors can click the text to tick the box. The W3C tutorial on form labels explains why this also helps accessibility.
Common mistakes include leaving out the field name, forgetting the options, or missing a closing bracket. Each one can stop the field from appearing.
Curly quotes are another frequent problem. If you copy a tag from a document or website, the straight quotes may turn into curly ones, and the tag breaks. Retype the quotes by hand in the form editor.
Should you use an acceptance checkbox instead?
Use the acceptance tag for a single consent box, such as agreeing to a privacy policy, because it is built for that job and works differently from a normal checkbox.
The acceptance tag wraps its text, like [acceptance your-consent] I agree to the privacy policy [/acceptance]. By default, the form will not send until the box is ticked.
If you wrote an acceptance tag without the closing part, or used the old single-tag style, the box may not show as expected. The Contact Form 7 acceptance checkbox guide covers the current syntax and options.
This is general information about consent boxes, not legal advice. Check your own privacy obligations for the regions you serve.
Is the right form on the page?
Make sure the page uses the shortcode of the form you edited, because sites often have several similar forms and it is easy to edit the wrong one.
Make sure the Contact Form 7 plugin is active and up to date. Then go to Contact, Contact Forms and copy the shortcode shown for the form you changed. Compare it with the shortcode on the page.
Also check that you clicked Save in the form editor. Contact Form 7 shows a configuration error notice if something in the form or mail settings is wrong, so read any warnings at the top of the editor.
Our guide on how to use Contact Form 7 covers the editor and shortcodes if you are setting up a new form.
Could caching or a plugin conflict be the cause?
Yes, page caches can keep showing the old form after you add checkboxes, and optimization or form styling plugins can hide or break the new fields.
Clear your caching plugin, any server cache and your CDN, then test in a private browser window. Our guide on how to clear cache in WordPress lists the usual places.
Optimization plugins that combine or remove unused CSS can drop the styles that make checkboxes visible. Exclude Contact Form 7's styles from those features and retest.
If that does not help, run a conflict test on a staging copy. Our guide on finding which plugin is causing a problem explains the process step by step.
Why do checkbox values not show in the email?
If the checkboxes appear but the choices are missing from the email, the mail tag in the Mail tab probably does not match the checkbox field name.
Each field has a mail tag with the same name in square brackets. A checkbox named your-interest needs [your-interest] in the message body of the Mail tab.
When several boxes are ticked, Contact Form 7 joins the values with commas by default. If nothing is ticked, the tag is left empty.
Our guide to Contact Form 7 mail settings covers mail tags in more detail.
If emails are not arriving at all, see fixing Contact Form 7 not sending.
What is the quickest fix checklist?
Work through these checks in order, since the first two solve most cases.
- Inspect the form to see if the checkbox HTML exists.
- If it exists, add CSS to restore Contact Form 7 checkboxes.
- If it does not, check the form-tag name, options and brackets.
- Retype any curly quotes as straight quotes.
- Confirm the page uses the right form shortcode.
- Save the form and read any configuration warnings.
- Clear all caches and test in a private window.
- Run a plugin and theme conflict test on staging.
Once the boxes appear, submit a test entry and check that the email includes the choices you ticked.
Frequently asked questions
How do I add a checkbox in Contact Form 7?
In the form editor, click the checkboxes button or type a tag such as checkbox, then a field name, then each option in straight double quotes, all inside square brackets. Save the form and add the matching mail tag to the Mail tab so the choices appear in emails.
Why are only the labels showing without boxes?
Your theme or a plugin is hiding the checkbox inputs with CSS, often using display none or appearance none. Add a CSS rule that targets checkbox inputs inside the Contact Form 7 form and restores their display and appearance, then clear your caches.
How do I make a Contact Form 7 checkbox required?
Add an asterisk after the word checkbox in the form-tag. The form will then show an error if the visitor submits without ticking at least one option. For a single consent box, the acceptance tag is the better choice.
How do I let visitors pick only one checkbox?
Add the exclusive option to the checkbox tag. Contact Form 7 will then untick other options when one is selected. If only one choice should ever be allowed, a radio button field is usually clearer for visitors.
Sources
- Checkboxes, radio buttons and menus Contact Form 7
- Acceptance checkbox Contact Form 7
- input type checkbox MDN Web Docs
- appearance MDN Web Docs
- Contact Form 7 WordPress.org Plugins
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.


