This post is no longer updated. Move to Contact Form 7 official site.
Download | Plugin Homepage | FAQ | Support Forum
- Where is the settings page for Contact Form 7?
- How can I add a contact form into my post content?
- How can I add a field to my contact form?
- Nothing shows up in the email, even after adding a tag to the form! How can I include a new field’s input in the email?
- I get emails containing codes such as [foobar]. What’s this? I want to see the user’s input.
- How can I specify a subject for the email?
- Can I place a contact form outside a post?
- Can I embed a contact form into my template file?
- After submitting the form, I get an error message stating “Failed to send your message”. What is wrong?
- I get an error message with a red border. So, how can I solve this?
- I see a response message “Your message was sent successfully” with green border, but I never receive a mail for that.
- The spinning arrow icon shows up once I submit a form, but then nothing happens.
- My contact form behaves oddly on certain browsers.
- I want to use contact form in my language, not in English. How can I do that?
- CAPTCHA does not work; the image does not show up.
- CAPTCHA’s text input box is working on Internet Explorer, but not with Firefox. I cannot enter the code.
- File upload & file attachment do not work.
Where is the settings page for Contact Form 7?
Log into WordPress and open Settings > Contact Form 7.
Update: It’s in Manage > Contact Form 7 since Contact Form 7 1.8.
Update: WordPress 2.7 moved the page to Tools > Contact Form 7.
How can I add a contact form into my post content?
Open the settings page for Contact Form 7, and then open the contact form you want to add.
Each contact form has its own tag, such as [contact-form 1 "My contact form"]. To insert the contact form into your post, copy the tag and paste it into the post content.
How can I add a field to my contact form?
To add a field, add a tag to the Form textarea.
Each tag has a strict syntax, supporting several options (see Contact Form 7 Tag Syntax).
Learning the syntax might be difficult, but you can easily make a custom tag by using the tag generator instead. Click Generate Tag and simply select the options you’re interested in.
Nothing shows up in the email, even after adding a tag to the form! How can I include a new field’s input in the email?
You need to add a new tag to the Mail fields. This tag should correspond to the tag in the Form you wish to include in the email. Thus, when you add a new form tag such as [text your-new-field], the corresponding email tag would be [your-new-field]. Only the second part of the tag (“your-new-field”, in this case) is needed for the email.
A tag in the Mail field will be replaced with the user’s input contained in a form field with the same name.
I get emails containing codes such as [foobar]. What’s this? I want to see the user’s input.
See above. In this case, no form tag corresponds to the [foobar] email tag. A tag in the Mail field which has no corresponding tag in the Form will be left without replacement.
How can I specify a subject for the email?
Simply edit the Subject field in the Mail section (not in the Form section).
Can I place a contact form outside a post?
Yes. You may place a contact form in a text widget as well.
Can I embed a contact form into my template file?
No, this functionality is not yet supported.
After submitting the form, I get an error message stating “Failed to send your message”. What is wrong?
There could be two causes for this. The first is actual mail server trouble, where email cannot be sent. In this case, the error message would be surrounded with a RED border line. Contact your server admin.
The second possible cause is that the form content is classified as spam by Akismet. In this case, the error message would be surrounded with a YELLOW border line.
I get an error message with a red border. So, how can I solve this?
There are really various reasons for server side problems, so I can’t explain exactly what yours is. But experiences of other users who solved their problem might be helpful for you.
Mario Vargas says he solved a mail-related problem with WP-Mail-SMTP plugin.
I see a response message “Your message was sent successfully” with green border, but I never receive a mail for that.
Showing the green border message means that the PHP function for sending the mail has certainly completed successfully. So if you can’t receive the mail, it’s highly possible that the mail has been kidnapped or killed after that.
If you can check the log of your mail server, it could give you some clues. Spam filter often causes this kind of problem.
The spinning arrow icon shows up once I submit a form, but then nothing happens.
This is most probably due to a conflict between plugins. Try deactivating all other plugins.
My contact form behaves oddly on certain browsers.
This may be caused due to invalid HTML, CSS, or Javascript. Please check your form page with a validator or debugging tool.
Useful tools:
Firebug — Firefox extension. Good for Javascript debugging.
XHTML-CSS Validator — A validator with a good UI.
I want to use contact form in my language, not in English. How can I do that?
Contact Form 7 has been translated into many languages. See if the languages folder contains a language file for your language.
The locale setting of Contact Form 7 follows the locale setting of WordPress. Once you change the WordPress locale to, Contact Form 7 is also changed. See how to change the WordPress locale here.
CAPTCHA does not work; the image does not show up.
To use CAPTCHA, you need GD and FreeType library installed on your server. Also, the contact-form-7/captcha/tmp folder must be writable.
Contact Form 7 1.8 and later require wp-contents/uploads/wpcf7_captcha folder writable, instead of contact-form-7/captcha/tmp.
Update (2009/03/23): Contact Form 1.9.4 and later refers your upload folder setting in Settings > Miscellaneous menu for resolving the base directory for CAPTCHA’s temporary folder. So it may not use wp-contents/uploads/wpcf7_captcha. For example, when your upload folder is set “wp-content/myfiles”, CAPTCHA temp files will be created in wp-content/myfiles/wpcf7_captcha, so you need to make that folder writable.
CAPTCHA’s text input box is working on Internet Explorer, but not with Firefox. I cannot enter the code.
This is a well-known issue caused by misusing the <label> element. Make sure you are using it correctly.
This is good:
[captchac your-captcha]
<label>Enter the code: [captchar your-captcha]</label>
This will not work correctly:
<label>[captchac your-captcha]
Enter the code: [captchar your-captcha]</label>
File upload & file attachment do not work.
See this post.
440 replies on “Contact Form 7 FAQ”
flikteoh, check your wp-content/uploads directory. There should be wpcf7_uploads directory under it and it should be writable. Contact Form 7 automatically creates it, and then uploaded images are temporary copied into the directory. If you don’t see it, manually creating it might help.
Hi, thanks for an awesome plugin, i used CForms previously but was unable to use it with some themes and your plugin works perfectly in these so i am currently switching all my sites over :). I am however having a problem styling individual titles for the fields, i have seen the previous css styling answers relating to ‘input’ but cant seem to find how to style the titles for the fields. Any help would be much appreciated.
OK, I figured out that the theme css styling can be applied in the contact 7 admin area, however i cant figure out how to style the input fields differently depending upon whether they are currently ‘selected’ or not, and also how to style these without affecting the send button. Thanks in advance.
how do i enable my contact form with the new version of wordpress, it used to work fine untill i updated. Is this a thunderbird issue?
For everyone who wants to change the size of your text boxes, just go into your theme’s style sheet and add this:
form {width: whatever you want}
textarea {same}
Is there any way to add SMTP details? The form sa ys the message was sent, but i never recieve anything.
Thanks!
rmilano, it must be some conflict with another plugin, i using 2.7 nd its working just fine. Anyone know how to do css styling for selected and not selected forms? Cheers
Alex, no, but I think there are other plugins specialized to do that. Contact Form 7 simply uses WordPress’ built-in
wp_mail()function. Managing the inside of sending mail activity is not where Contact Form 7 should address.hye miyoshi..
thankz for this plugin ..
please ignore my last comment, it is fixed now it was doing something wrong. thanks for this great plugin.
Hi Miyoshi,
What a great job with this plugin–well done!
I have a question you will quickly be able to answer. I can not get the selections that people are choosing in my template to show up in the response e mail that is showing up to me. What is the code to do that? Here’s the top 2 lines of my form:
What would you like to do?[select menu-313 “Reservation” “Comment” “Message”]
Choose a Restaurant: [select menu-313 “Food 101 – Sandy Springs” “Food 101 – Morningside” “Meehan’s – Vinings” “Meehan’s – Sandy Springs” “Coastal Kitchen”]
When they make their choice, I see nothing. I have tried several tags for the “message body” area to no avail.
Thanks for any help…much appreciated!
Steve B, in this case, you’ll need:
[menu-313]in the Message body text area.
You can find it in the FAQ, too.
But in this case, two drop-down menu shares the same name ‘menu-313’, so it will cause a conflict. You need to change the name of one.
Works with my G mail account But i am not getting any mail for my google Apps account.Do i need to configure my Google apps e mail account ?
Please advice
Is there anyway to be able to grab the IP of the person who sent the form? To try and avoid SPAM, and just to have for the sake of being able to know the senders IP?
hi, i like this plugin, thank a lot for your work.
the plugin is working fine but i got little small problem with color of the message field, i managed to add the color for input but the message field seems not change, i got all the white background, please let me know if anything to add in css, thanks
you can view my contact form here
http://khmerbird.com/contact-me/
daydreamz, place
[wpcf7.remote_ip]in the mail body template. It will be replaced by client IP address.khmerbird, the message field is a textarea, not an input. Apply the style to the textarea.
@miyoshi
why my contact form doesn’t load the ajax scripts, actually the first I installed it they are working good.!
:(
patembe, check your page with Firebug. Other loaded javascripts might be causing conflicts.
@miyoshi
:( I have check it out using Firebug. But the notification say:
jQuery(“div.wpcf7 > form”).ajaxForm is not a function
I still confused how to fix it manual…could you help me brother! :D
Love your contact form. Just great!!!
[Please delete my other comments…]
Hello
I have a question.
How I can do for have a “submit” button with this options please:
name=”submit”,
type=”image”,
src=”/design/article/a-exp.png” id=”submit” tabindex=”5″,
value=”Envoyer”,
class=”a-exp”
Thanks for your help
Happy New Year !
patembe, try disable other plugins loading javascripts. At least, you don’t need jQuery loaded twice, do you?
Buran, image submit button is not supported currently. I think you can realize it with javascripts, though.
@miyoshi
Yippe..
Fixed…..! :D
Thank you brother.
Success Regards from me.
:)
btw, do you have any yahoo messenger address.
I hope we could make friendship from here.
this is mine: angga_xn@yahoo.co.id
patembe, glad to hear that. Unfortunately, I have no yahoo messenger account, so please contact me by blog comments, gmail or twitter. Thanks.
The form is fantastic. Although I would like to move the validation and errant messages to the top of the form. Where would I go about doing that?
marc wiseman, it needs editting in the PHP source. If you know well, look into the wp-contact-form-7.php line #869 – #902. I’ve been thinking long about an elegant alternative way to do that.
thank Miyashi, i managed to make the different in textarea now, very happy with it.
I don’t get any emails when I submit using the form. I enter all the details but I don’t receive any email nor do I see any comments in my dashboard.
What am I doing wrong?
Form available at this page
http://astherbals.com/
forgot to add… I get the your message was sent confirmation. the email i’d like the form to forward to is the one available in this comment.
thanks
Khan Obair, check spam filters, read logs on your mail server, make sure if this is an issue of the plugin, and contact your server admin.
I’m trying to make contact form 7 work in IE with the text widgets to make a newsletter sign up. The problem is that in Firefox it works fine, and sends flawlessly, but in IE, it does not. Is there anything i can do, or that can be done to repair this little mishap? Mail me back, or go to my personal site and use the contact form to contact me. :) thanks in advance. I’ll check this regularly just to be sure.
Craig, see FAQ.
My contact form behaves oddly on certain browsers.
This is a great plug-in — thanks. One question, though. Can I somehow hide the form in posts until a correspondent clicks a hotlink that then opens the fields below a post?
Would it be possible to have a required radio button field where one of the radio choices is already selected?
Also, I’m seeing a JavaScript error with the latest version of Contact Form 7:
Error: jQuery(“div.wpcf7 > form”).ajaxForm is not a function
Source File: http://www.webcommons.biz/wp-content/plugins/contact-form-7/contact-form-7.js
Line: 5
Thanks Miyoshi ;-)
Submit button will be supported in next version ?
great, thanks!!!
Steve Magruder, radio buttons are required by nature. Default selected value can be set with default: option.
Steve Magruder, your theme is mistakenly loading jQuery twice. It is causing conflicts. I suggest you to ask the author of the theme to correct it.
Love the plug-in.
How can i place to forms next to each other on the same page. It appears the brackets force any thing after it to the next line.
ie. [contact-form 1 "Tech Support"] [contact-form 3 "Door Code"]
To follow up how can I get my two forms side by side? The shortcode doesnt seem to let me place them inline or block. Is it possible to concatenate the forms from with in the WP editor?
[contact-form 1 "Tech Support"] + [contact-form 3 "Door Code"]
r3y, this is a CSS matter. Basically they are blocks. To force them represent inline, you can use display: inline;. Or you can get it with float: left;. Please see the manual of CSS in detail.
Thank you. For the response. I wasn’t able to us css cause i didnt know how to access the code i needed. I did find a more direct approach, that suites me. Hopefully it will help others as well.
<?php
$door = do_shortcode(‘[contact-form 3 "Door Code"]‘);
$tech = do_shortcode(‘[contact-form 1 "Tech Support"]‘);
echo”.$door.”;
echo”.$tech.”;
?>
This way you can embed the form directly into a template.
I tried everything in the FAQ and all seems pretty good except the IE issue. Firefox worked just fine, i didn’t test Opera, Chrome or Safari because they’re not common at all. Is there a way around this? I can’t hardcode it to the sidebar because all the default widgets in there don’t stay if you put in new ones.
@r3y wow it looks good… I couldn’t have such idea. Really interesting. It may give a way to theme-embeded form.
@Craig where is the site of the issue? Have you done XHTML validation and checked Javascript errors?
I’m setting up a new website, and like your easy to use forms plugin.
I added a phone number field to the default form. When the email arrives it lists all of the other lines, but not all of them. The log shows the missing lines.
Why is this? Here is the form –
Your Name (required)
[text* your-name]
Your Email (required)
[email* your-email]
Your Phone
[text* your-phone-number 18/18]
Your Wedding Date
[text your-subject 18/18]
Your Message
[textarea your-message]
Please enter the letters and/or numbers – [captchac captcha-652 size:m]
[captchar captcha-652]
[submit “Send”]
@Allan Levene, insert
[your-phone-number]into the message body textarea in Mail fieldset.See also…
How to customize form and mail contents
Nothing shows up in the email, even after adding a tag to the form! How can I include a new field’s input in the email? (FAQ)