Contact Form 7 FAQ

This post is no longer updated. Move to Contact Form 7 official site.


Download | Plugin Homepage | FAQ | Support Forum

(日本語の FAQ はこちら)

  1. Where is the settings page for Contact Form 7?
  2. How can I add a contact form into my post content?
  3. How can I add a field to my contact form?
  4. 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?
  5. I get emails containing codes such as [foobar]. What’s this? I want to see the user’s input.
  6. How can I specify a subject for the email?
  7. Can I place a contact form outside a post?
  8. Can I embed a contact form into my template file?
  9. After submitting the form, I get an error message stating “Failed to send your message”. What is wrong?
  10. I get an error message with a red border. So, how can I solve this?
  11. I see a response message “Your message was sent successfully” with green border, but I never receive a mail for that.
  12. The spinning arrow icon shows up once I submit a form, but then nothing happens.
  13. My contact form behaves oddly on certain browsers.
  14. I want to use contact form in my language, not in English. How can I do that?
  15. CAPTCHA does not work; the image does not show up.
  16. CAPTCHA’s text input box is working on Internet Explorer, but not with Firefox. I cannot enter the code.
  17. 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.

faqimg1.png

How can I add a field to my contact form?

To add a field, add a tag to the Form textarea.

faqimg2.png

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.

faqimg3.png

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.

File uploading and attachment with Contact Form 7

440 thoughts on “Contact Form 7 FAQ

  1. Hi, Great plugin!!!!
    Here’s a CAPTCHA idea that may help some people. I had a WordPress site in a subdirectory. When I moved the site to the root, WP worked fine, but Captcha stopped working, showing a word instead of the image.

    I went to Settings…. Miscellaneous…. “Store Uploads in this folder”. When I fixed that path, boom, everything was fine! Hope this helps someone.

    Thanks again!

  2. hello,

    All seems to be working fine except that I never get the email of the sender. When i receive an email, sent from the filled-in form, the From section appear with the name of the person who sent it but with my own email… where is the problem?

    Here are my settings:

    Your Name (required)
    [text* your-name]

    Your Email (required)
    [email* your-email]

    Your Country (required)
    [text* your-country]

    Subject
    [text your-subject]

    Your Message
    [textarea your-message]

    [submit “Send”]

  3. This form was very easy to set up, but I am having some trouble. After filling in the form it is saying that the form was successful, but I never receive any emails. Why would it be doing this?

    Please help! Thanks!

  4. Hi !

    I’m having som porblems with the CAPTCHA Plugin…

    The plugin tryes to load the images from: “/wp-content/uploads/wpcf7_captcha/”

    But they are stored here for som ereason:

    “/wp-content/wpcf7_captcha/”

    Can i change that some how ???

    Thanks…

    Kind regards,
    Morten

  5. “…All seems to be working fine except that I never get the email of the sender. When i receive an email, sent from the filled-in form, the From section appear with the name of the person who sent it but with my own email… where is the problem?”…

    I have the same problem. I can show the sender’s email by putting the field value in the message body but i receive the mail from my own name (and setup mailaddress) and not that one that the sender filled out..

    please let me know a solution

  6. Hi,

    Contact form 7 is great but one thing is confusing. When it defaults to [your-email] in the from area, this made me think that I would be able to hit reply and respond to the sender. However, it puts in a wordpress admin email. When I manually added [your-email] in the coded response, the email of the sender actually showed up.

    Amanda

  7. One more thing…is there any way for email from the forms to be stored in the admin area for a period of time? I have no way of responding to the ones that came from “admin@***.***.***.” (the site IP) address, since that’s what it’s putting into the “from” field.

    Amanda

  8. Of all the contact form plugins for WordPress, this one is the most troublesome. It rarely works.

    Follow all the instructions, check everything, and still no captcha. When captcha does show up, it says that the number does not match.

    This plugin is a huge waste of time.

    Give it a skip.

  9. Is there any way to forward to another page once the contact form has been submitted? Or is there any way to add a link into the thank you message?

  10. Takayuki,
    You have created a great mail form. After sending the email, how can I redirect it to a different page?

    Thank you in advance

    Data

  11. Hi, Can anyone tell me how to change the custom validation error message of ” Name field is required” ?
    I hate the word “field”, I want to show it up like ” Name is required ”

    Moreover, the error message is popped up over the text box itself. Is not possible to show it below the text box or adjacent to it ?

    Any help ?

  12. Hi,
    i’m using this great Plugin on my WebSite.
    But since the Last one, or two WP-updates it make a mistake.
    If i press the Send-Button, the form was send correctly, but the User read a ‘Error 404 – Not Found’.

    I think the Problem is the line ”, because the not found Site is ‘http://www.aaa.de/xx/yy/formular/#wpcf7-f3-p39-o1’.
    I hope you can help me to eliminate this error.
    In former WP-Versions until 2.7 there was no errors…

    Cheers Andi

  13. Hi –

    Great plugin – :)

    This may be a dumb question but I am having a difficult time in getting the contact form to send the contents of the form to multiple mail recipients.
    Simply seperating by a comma does not appear to work?
    Any ideas?

    Thank you!

  14. i have the same issue as andi.

    contact form not found is being shown on the page,

    when i try to add new form it says it is completed. but nothing ever shows up.

  15. Hi,

    ehre can i change the output text-color of contact form 7? Can someone give me a hint? Thanks!

  16. Come on, Is there anybody to give any kind of solutions to those questions. All those questions are just sitting there

  17. Good question. Who on earth checks blog comments for answering other people’s questions? You should send your questions to the support forum because you can find more people there. However, no one see blog comments, even THIS comment, and similar kind of questions will be continuously posted here. I’m just talking to myself.

  18. Hey Miyoshi,

    First thing, I would like to thank you for the awesome plugin. Second thing, I knew only about this blog, and I just saw the questions but no answers. So I thought, is the blog alive.

    thanks for the link tot he forum.

    BOB

  19. here’s my Contact Form working fine in Firefox

    Your Name (required)
    [text* your-name]

    Your Email (required)
    [email* your-email]

    Your Mobile No.(required)
    [text* mobile]

    Subject
    [text your-subject]

    Your Message
    [textarea your-message]

    [captchac captcha-249 size:m]
    Enter The Code: [text captcha-249]

    [submit “Send”]

  20. Hi all,

    In My Site its Working…

    form Details…

    Your Name (required)
    [text* your-name]

    Enter Mobile Number (required)
    [text* MobileNumber]

    Your Email (required)
    [email* your-email]

    Subject
    [text Subject “Request Free CD”]

    Address
    [textarea Enter-Address]

    [submit “Send”]

    Mail Details…

    to:
    bezopraviin@gmail.com

    From:
    [your-name]

    Subject:
    [Subject “Request Free CD”]

    Message Body:
    [your-name]
    [MobileNumber]
    [your-email]
    [Subject “Request Free CD”]
    [Enter-Address]

    Hope It will Work to you Too…

    I too searched this comments and found nothing….
    If My Comment Seemed To Be Useful, Just leave a Comment In My Site…

    Regards,
    BeZo Pravin E
    WinlifeIndia.com

  21. @nakedjaxx

    hi,
    I’ve found the workaround to style the input box. Open the style sheet file “stylesheet.css” found inside the contact-form-7 folder of your plugins folder. Ignore the comment.

    Add this line:

    div.wpcf7 input {
    border:1px solid #BDD6E0; //for testing purpose
    height:30px; //for testing purpose
    }

    I’m also working on the styling part :)

    hope that helps.

  22. I’ve added a phone number field but it does not validate the input at least to check that only numbers were typed in instead of other characters.

    please help. thanks.

    jonathan

  23. Hello,

    I am using the form and it is great.

    Thank you.

    I wonder, is there any way to attach a message ID? This means each time I get a message there will be generating a unique ID number, or kind of support ticket number.

    It will be really nice if possible.

    thank you!

  24. I am using contact form 7. After form submission i want to redirect to thank you page. How to do that?

  25. Hi!
    This is a really great Plugin!!

    On my homepage I want to let registered users to make a online Feedback. Is there a possibility to use this registered Mail as “from”?

  26. What do you type to show in the email the results of [radio Gender “Male” “Female”]? I want the email to show the answer, whether the person IS male or female.

    Same for Date of Birth – I have a drop-down with month, day and year. Is it [Month] or [select Month] or what do I put in the email to show the month that was actually chosen?

    Thanks for an awesome plug-in.

  27. OK, guys, I figured it out myself.

    In the email, just put [Gender]. It will show you the gender.

    For date of birth: [Month] [Day] [Year]

    …assuming that’s what you named your fields.

    To show up in my email, I typed this:

    Gender: [Gender]
    DOB: [Month] [Day] [Year]

    and it came out just fine.

    hope this is helpful to everyone that had the same question as I did.

  28. Hi,
    I got a error here.
    Once it is activated in my blog, my widget box of the recent entries/achieve/comment stops working properly. It will return normal if i deactivate the Contact Form.

    Can u tell me how to fix it please?

  29. How do I make the Contact Forms larger? My content width is 620px, but the contact form only seems to be about 400px or so. Is there a way to customize the size so that it fits my pages?

    Thanks.

  30. Very nice plugin ;-)
    Everything works fine, but the file attechment doesnt work very well.

    If I attach a file in the form [file-xxx] the content of the file is base64 coded directly inside the email, not as an correct attachment?

  31. i get the spinning circle when i click the Send button, but nothing happens. already tried deactivating all other plugins but it’s still just spinning there. anyone can help?

  32. Sorry I have to post my question again ‘cos I forgot to set the email notify. I need help to get the file upload tag to work. Trying to build 2 upload 1 for pics and another for docs. Can’t seem to get it to work. My web hosting service I use squirrel mail to read.

  33. How can i validate a phone number field in contact from at least i should be able to check if the entered value is numeric please help …

    Thanks in advance

  34. For me, the message part of my contact form is a little too wide for the page it’s on. Is there a way to adjust its size?

  35. Still no multiple recipients, and also, it always overwrites the “from” information with the sites’ information, so you have to be careful to embed the user information into the body, or else you won’t have the name and email address of the sender!

  36. Hi, I think this is a great plug-in but since my website has a white background, I was wondering if there is away to color text field box to other colors or not with the current release. Is yes, may I know how?

  37. Hi, I added this new field
    Pratichi attività fisica?
    [select menu-352 “mai” “sporadicamente” “di frequente”]

    how can he send me the answers by mail?
    please write me the exact code to enter through.
    thank’s so much

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s