Categories
WordPress Plugins

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 replies on “Contact Form 7 FAQ”

Hi! Your plugin is very great! Thanks a lot!
I want to ask you if is it possible to view or insert a tag with the IP Address when you receive the contact form by email.
Thank you again!
Best regards
maga

is there a possibility to include in next versions customized status messages for each form independently, like thanks for sending your message and thanks for suscribing to the newsletter??

Great form! My only problem is that the “from” address never appears in the emails that are sent.

I’ve copied the same tags into the body of the email, and the “from” name and email address are inserted properly. For some reason, the won’t show up in the “from” field in received emails, however.

Any idea why this is happening?

Brad,

The mail protocol specification provides syntax of ‘from’ field, like

Sender’s Name <senders-address@example.com>

You should check your tag used as following this rule.

Is it possible to class elements for styling purposes, something like: [submit class:custom_button “Submit”] ?

I love your plugin, the best contact form out there!

But I would like to warn you about a strange behaviour
with the captcha on Firefox: the textbox loose the focus, that way is impossible to fill the captcha code,
except keeping mouse down while typing… (firefox 2.0.0.13)

Hi,

Thank you for the plugin! It is great. I love it. Two features that I would love to see are:

1/ option to copy existing form and modify (instead of starting building the form from scratch.

2/ option to create envelope-from (I am not sure this is possible). If it is possible, then envelope-from would allow me to specify domains in which forms are used. Like, when the form is under domain.tld, then envelope-from would say . Great for virtual domains but I am not sure if it can be used at all.

Anyway, thanks for your work! It is definitely appreciated!

Zbigniew Szalbot

First, reader sebastian daru says:
April 9, 2008 at 9:47 pm
is there a possibility to include in next versions customized status messages for each form independently, like thanks for sending your message and thanks for suscribing to the newsletter?

Isn’t this already possible by checking Mail 2 and dropping the fields in there? I am developing a site for a non-profit that is using three forms, subscribe (newsletter), join, and donate. On each of those I have mail2 checked and the user gets customized confirmation after he/she hits the submit button for each of these forms.

And I love, love, LOVE this form. I could only love it more if two things happened:

1. ability to specify a specific page that the user is returned to after he hits the submit button; and

2. ability to embed form in sidebar without using widget.

Thanks for your hard work on this most excellent plugin!

zbyszek,

I’m planning to include 1/ into next Contact Form 7 1.8.x. Import/Export feature.

About 2/ envelope-from, I don’t think it is a thing contact form plugin should manage.

Thank you for the suggestions, anyway.

Joni Mueller,

Thank you. They are not implemented, but you’ll be able to do so with Contact Form 7 2.x and a bit customizing. Maybe.

Hello miyoshi. Great plugin.

I was curious how I would go about adding a custom question field to remove spammers.

I would like to add what is 1 + 1?

If the user doesn’t submit 2 in the form, then it wouldn’t allow the comment to be sent. Is there any way to do this?

How do I position the “message successfully sent” banner at the bottom of the form? I have a very long form with multiple send buttons all down the page (so if they click on the send up the top of the form they can’t see the confirmation at the bottom of the form). I would like to position MULTIPLE banners throughout the contact form… maybe at the very top and in the middle? (basically below each send button would be ideal).

OR… can the page be automatically taken down to the bottom of the form after the submission?

Thanks pete

Kyle,

At this time this plugin does not support the feature like you wrote. I’m considering to include it into version 1.8 todo list.

Using WordPress 2.5.1, contact form 7 1.7.7.
Captcha is working allright on MS Internet Explorer 7, but not with Mozilla Firefox 2.0.0.14.

When trying to enter the captcha code, the cursor disappears right away. If you click into the captcha input field and hold down the mouse button, it’s possible to enter the code.

So it is some sort of a programming problem?!

Kind regards
Martin Fischer

Martin Fischer, it’s not a problem of the plugin. It is a well known phenomenon caused by misusing of <label> element. Check your form and remove <label> around the captcha tags if possible.

Hi,
bit of a rookie here! i’m trying to install the contact box but the spinning arrow doesn’t disappear!
I know the FAQ tells you to de-activate all the other plugin’s, but will this mean they will stop working on your site?

louise, yes, but it is just for an investigation. Once you find the plugin of the cause or find nothing has problem, you can activate them.

How can I specify a subject for the email?
You didnt realy answer the question in you FAQ.
Anyone who has gotten this far expects that you have to
“Simply edit the Subject field”.

I want to be able to know which web site the email using this form comes from as I have more than one. Normal contact forms have a provision for specifying the subjet that tell site owners that.

I have tried editing the Subject field
Subject
[text your-subject]

every which way I can imagine. Is there away to have a part of the subject imbedded in the form so that each email coming from the form identies where its from?

Its really an elementary thing and should be part of your standard install?

OK now I have got it. You need to make instructions idiot proof for some of us.

May I suggest you edit your FAQ on “How can I specify a subject for the email” to :-

“Simply edit the Subject field in the Mail section (Not the Form Section)”

Thanks so much for the Contact Form plugin, It’s an essential and actaully smooth to use.

i have problem IE7, when i m place contact form in righsidebar image were loading and doest will be happens but unfortunately its working on FF2 so plz any body help me what can i do for resolving the issue

Is it possible to use your contact form and add these lines in the script that would send the data to a master database.

Ex. <input name=”write_to_mysql” type=”hidden”…..
<input name=”mysql_table” type=”hidden” value=…..

Thanks

Hey, I was just wondering if it’s possible to remove the javascript, seeing how the forms works without it. Could I just comment out the whole function wp_head()?

hi, great job! i´m a wordpress beginner and your form is easy to use.

i have a special problem: i insert a drop down menu and checkboxes in my form, but the results dont appear in the email. what kind of tags is the right?

thank you!!

Is there any way to get rid of the line-break tags that get generated with this plug-in?

( the tags )

They keep coming up around the SPAN tags that get generated.

Thanks

Peace

i was referring to the BR tags – the tag formatting got deleted from that post above

How do you style the forms or the tags? Like I added the tag for a dropdown menu, and it is smaller than the rest of the fields – like “Subject” “Name” and “Email”. How can I make the field the same size?

Thanks.

Hello, Your plugin is awsome! i just have one problem. i use a lot of javascript in my posts, and when i activate your plugin, all posts seem to be parsed in some way, and all the ‘ become \’ therefore the scripts aren’t working anymore! can you tell me the linke of code where this is done, or do you know some sort of fix for that?

best regards!

Hello –

Thank you for this plugin! It seems to do all that I need.

One thing I would like: The “Message Sent OK” is displayed quite low, and I’m afraid some of my users may not see it. (This is especially important because with your form users don’t go to a different page when they’re done and thus may wonder if it went through.) Any way to move that message up?

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