A Site for WordPress Plugins

WordPress Quick Contact Form

When you fire up the plugin a basic form is already configured and ready to use. All you have to do is enter your email address and add the shortcode [qcf] to your posts or pages.

There is a lot more functionality now that there was at Version 1 but the form still works right out of the box: just add your email address and it’s ready to go.

What do you get for your money?

Quick Contact Form admin page

Quick Contact Form admin page

  • 12 selectable fields including name, email, telephone, dropdowns, checkboxes, dates, radio fields and range slider
  • Attachments (with optional restrictions)
  • Optional captcha
  • Multiple forms all managed through a single dashboard
  • Message display and download function
  • Editable thank-you message
  • All sort of validation and customised error messages
  • Selectable tracking
  • Akismet spam filtering
  • Redirections
  • And a whole bunch of styling options


Here’s some examples

You can see examples of the form on this page. Have a play and you will see the error and thank-you messages. Everything you see can be edited and changed: fields, headers, messages, colours, fonts, borders and backgrounds.

Getting Started

There are some basic instructions for use on the plugin settings page.

I’ve also begun to put together an idiot’s guide. Only in English though. If you would like to help with a version for your language I would be most grateful.

The QCF Instructions for Use

Errors and Problems

If you use aol, gmail, yahoo, hotmail, live, aim, or msn you could find your email getting blocked by the host. I’ve updated the plugin so there is option to send using SMTP. This should solve the problem. If it doesn’t then try this troubleshooting guide.

The datepicker can sometimes default to English. WordPress should look after this but can get it wrong. There are a couple of solutions to help with localizations.

Download the Plugin

Here’s the plugin: http://wordpress.org/extend/plugins/quick-contact-form

Join in the fun

If you want to help with the plugin drop me a message and I’d send you the beta versions as they get developed. In return you get a mention here and on the wordpress plugin page.

  1. Csongor on 13 Feb 2013:

    Hi there!

    First of all: great plugin, great job done, absolutely love the rather minimalistic, straight to the point design.

    I have only question regarding the (excuse me if I am not that tech savy) “onclick” function. It drives me FREAKING NUTS when clicking on the text field, the field label disappears.

    I saw in the .php files that you can tweak it, but I am not that good and I don’t want to mess up things.

    So, please, if you would be so kind to tell me what can I do to turn this feature of, I am sure it affects the UX on my site.

    Thank you in advance for your answer, have a great day!

    Reply to Csongor

    • Graham on 14 Feb 2013:


      Pleased you like the plugin.

      A text field has a different set of rules to a normal form field – I have no control over this. It’s not even really an ‘input’. As a result the label won’t reappear when you leave the field. It’s not something anyone else has commented on but I will take a look.

      I’m doing some upgrades at the moment so will see if I can find a solution.


    • Graham on 15 Feb 2013:


      Download and install version 4.5 and everything works as expected. I hope.

  2. Justin on 09 Feb 2013:

    I’ve installed 7 word press form plug-ins and yours worked for me. Love the fact that you can scale down the overall form size.
    I have a black background, so the “Thank you” message font is not visible since it’s hard coded to black. Can you tell me where I can change the code for this?
    Thank you,

    Reply to Justin

    • Graham on 09 Feb 2013:


      The plugin doesn’t define the font colour for the thank you message. It’s something in your theme colours.

      One work-aroud is to set up a thank-you page and send you visitors there when they submit the message. You do this in the ‘send’ options tab.

      What’s the URL?

    • justin on 10 Feb 2013:

      Thank you! I will probably end up creating a a thank you page!


    • Graham on 10 Feb 2013:

      Or you could use custom styles. On the styles page make sure the checkbox is selected and add the style: #qcf-style p {color: #FFF;}

      Save and see what happens.


  3. TJ on 31 Jan 2013:

    Is there a way to add more fields? I need 2 more text fields. Thanks.

    Reply to TJ

    • Graham on 01 Feb 2013:

      You can add more text fields but not via the plugin. You would have to work your way through the php and add then to the various arrays. Not difficult but quite time consuming. If you want me to do this for you I can but not for free I’m afraid.


  4. Enio on 28 Jan 2013:

    Thanks so much for your plugin, i really like it. I have a question to you. When I send to multiple addresses, I put a comma betweeen each address. But, is there a way to do it hiding addresses when sending to multiple recipients? Like a CCO? ….

    Reply to Enio

    • Graham on 01 Feb 2013:

      That’s an interesting thought. Adding lots of boxes for different types of recipients would be messy but I could add a checkbox for BCC (blind carbon copy).

      Let me have a play, mail('BCC: '.$qcf_email, $subject, $message, $headers); should work.

  5. Rich B on 05 Jan 2013:

    Hi Graham,
    Thanks for this plugin. It is easy and very well explained which is especially appreciated by a pseudo wanna-be techie like myself.
    However, no matter how hard I try, there is a glitch or two. In this case, two. One is that there seems to be no easy way to make the form align center on my page. It always goes left. I tried putting it in a table that was aligned center, but the form still appears aligned-left. Two, the top “Name” box is slightly offset to the right.
    I don’t know if these glitches are in the theme or the plugin. Any suggestions would be greatly appreciated. Thanks.

    Reply to Rich B

    • Graham on 05 Jan 2013:

      Aligning things in the centre is never easy. It works great for paragraphs and headers but is a right pain for everything else.

      The good news is that WordPress has built in styles you can use: alignleft, aligncenter, alignright: http://codex.wordpress.org/CSS

      Try putting the form in a DIV with class=”aligncenter”

      Don’t know why the name box is offset. It’s probably some other style that has sneaked in. Can you send me the URL so I can have a look

  6. tupi-wala on 22 Dec 2012:

    hello dear,
    i am using ur quick contact form & its simple awesome although having some problem. My problem is mail is not sending to my Gmail accounts. I have set another msn account and it works fine not working in gmail accounts. I used “,” to separate mail addresses. But still same problem. Please help!!

    Reply to tupi-wala

    • Graham on 24 Dec 2012:

      If messages are getting to msn and other recipients but not gmail then you need to talk to your host. The may be restrictions on the PHP mail() function. It is a common problem with shared hosting.

      Sorry that I can’t help more but it’s not a problem with the plugin.

  7. David Main on 04 Dec 2012:

    Hello Graham,
    Thanks for the simple yet versatile plugin – I was wondering if there is something I can add to #qcf-style – or anything that I could do, that would prevent the labels from disappearing when you click in a field to enter text? I realize that one solution is to reopen the page containing your contact form but apparently not all my visitors have that intuition. They’ve ended up not being sure of what the field was originally asking of them because they’ve clicked it away

    Reply to David Main

    • Graham on 12 Dec 2012:

      There are two ways to do this:

      1. Delete the quick-contact-form/quick-contact-form-javascript.js file
      2. Remove the lines: $myScriptUrl = plugins_url('quick-contact-form-javascript.js', __FILE__);
      wp_register_script('qcf_script', $myScriptUrl);
      wp_enqueue_script( 'qcf_script');
      from the plugin file.

      If you do click away without entering anything the field label should return. That’s how I wrote the thing. Can you send me a link to your contact page?

  8. Your name on 21 Oct 2012:

    Grayham, me again. I think this is out of you control but I keep getting emails which have been created using the contact form that are spam for a supposedly funding organisation. I know we don’t have a capcha but would enabeling the question after number question help to stop robots and if so how does the question work? if I put text in the box it shows on the form but I can’t see how you can get some to answer it correctly .

    Reply to Your name

    • Graham on 21 Oct 2012:

      Hi Alistair,

      The captcha should block most of the auto submitters. If the visitor answers the question correctly the form will get submitted. If they don’t then they get an error message. There is a version of the captcha that uses images to display the sum but I’ve never got it to work properly.

  9. Sol on 12 Oct 2012:

    Hi I installed the your contact shortcode on the frontpage of my website.

    Though it looks like the message goes, actually I don’t get any message/ email when I do some testing filling in the contact form.

    Seems there is no setting on the plugin page on wp backend to fix this. Should we check the code in editor?

    Please advise

    Reply to Sol

    • Graham on 12 Oct 2012:

      The problem seems to be with the hosting packages people use. The PHP mail function is restricted by your host so that emails to gmail, yahoo or hotmail get blocked. If you have a domain email (me@mydomain.com) it will work.

      There is a solution the other contact form plugins have use and it sometimes works. If you goto the help tab on the plugin settings page you will see the code.

      But I would ask your host first.

  10. Joe on 03 Oct 2012:


    Love your plugin – very flexible and slides nicely into our theme.

    I have configured everything and it appears to work – entries show up in the Dashboard – but the email never arrives.

    I use “Configure SMTP” for sending messages as I cannot use the web host’s standard “localhost” SMTP.

    Please help!


    Reply to Joe

    • Graham on 12 Oct 2012:

      The problem will be with your hosting/email config.

      The plugin uses the php mail function which is a simple email submission thing. If you aren’t getting the messages it’s because of some thing on your server. I’d like to help but I have no idea how your server is configured.

  11. Svpmerci on 26 Sep 2012:

    merci pour ce widget.
    le seul problème est la réception du mail.
    voici ce que cela donne :
    Content-Type: text/html; charset=”iso-8859-1?
    Content-Transfer-Encoding: 7bit

    The message is:Votre nom: cholletadresse: 2 bis rue ronsard 41500 merEmail: lotjfc@gmail.comTéléphone: 0631814305Caractéristiques: ibm hsprix: 30Message was sent from: Soumettre un produitSenders IP address:
    Content-Type: image/jpeg; name=”ibm1.jpg”
    Content-Transfer-Encoding: base64
    Content-disposition: attachment; file=”ibm1.jpg”


    j’ai essayé avec plusieurs adresses mails ( gmail ou yahoo ) toujours le même résultats

    merci de votre aide


    Reply to Svpmerci

    • Graham on 26 Sep 2012:


      There was a bug in the code I had missed. I’ve uploaded version 4.1 and tested it with jpg,gif,png,doc,pdf using gmail, yahoo, webmail anf thunderbird. So it should be ok. Can you update the plugin and test it for me.

  12. Kron on 26 Sep 2012:

    Thanks so much for this plugin, i really like it. However when i activate the validation in some fields like email or name in the published form inside a page only appear the fields without validation. Another thing is that in dashboard i can see the messages history but i never received any email.
    Do you have any idea regardin to this issues? thanks in advance.

    Reply to Kron

    • Graham on 26 Sep 2012:

      Not sure why the validation isn’t showing. Can you post your URL so I can take a look.

      The most common problem with emails not arriving is hosting restrictions. Many people using this and other contact forms have found that their hosts will only allow domain emails. Gmail, hotmail, yahoo etc all get blocked. Check with you host that their are no blocks on the PHP ‘mail’ function.

  13. Melanie on 26 Sep 2012:

    I’m attempting to use your contact form builder as an RSVP for my wedding site. I have gotten it set up however once I submit it I am not receiving a notification to my inbox about it and I am not getting a confirmation on the page. Can you help me with this?

    Reply to Melanie

    • Graham on 26 Sep 2012:

      How bizarre. Really not sure why you don’t see the reply. Do the messages appear on your dashboard?

      Edit: it turns out that their host was hopeless. The PHP was so out of date none of the contact form plugins worked! They changes hosts and all is hunky-dory.

  14. Ric on 26 Sep 2012:

    Hi, love the plugin. not too simple, not too complex, just right.

    Been hacking with it as I wanted to set the width as a percentage not as px. so changed things in function qcf_display_form( $values, $errors, $whichpage )

    worked but the dropdown field was displaying as much longer than all the other fields

    so I changed $input = ($width – $padding – $whichpage) . ‘%’;

    to $input = ($width – $padding) . ‘%’;

    now the dropdown is only marginally shorter. what exactly is $whichpage ?

    Reply to Ric

    • Graham on 26 Sep 2012:

      Aha, you have discovered the magical ‘whichpage’. All this variable does is make sure both the preview form and the live form both display properly. If you remove it from your version and adjust the calculations the live form will be ok but the preview form will look a little wonky.

      Nothing I can do about this, it’s because of the way wordpress dashboard is styled.

      However, you might want to wait a day or two. I have a new version nearly ready for launch that allows custom styles (as well as redirections and attachments).

    • Ric on 30 Sep 2012:

      Thanks for explaining. Cool look forward to the new version

  15. rocketjunkies on 26 Sep 2012:

    I worked on wordpress sites developments and have download install quick contact form plugin, I like this plugin a lot and work well, I dont work much in php and dont do custom php developments, I want one help when we get a message in our mail from quick contact form. its shows like tile “Enquiry from sender name” there are option like post, page or sender name we can select from.

    But I need to add 1 more line in title to get this “Enquiry from sender name and subject” it should show in title.

    can you please help me and tell where I can do this to get the the title as mentioned.

    please reply as soon as possible and help me.

    Reply to rocketjunkies

    • Graham on 26 Sep 2012:

      If you want more in the email subject you need to edit the line:

      $subject = “{$reply[‘subject’]} {$addon}”;

      Change it to:

      $subject = “{$reply[‘subject’]} {$addon} {$values[qcfname9′]}”;

      The number 9 only works if you are using field 9 for your subject. If it’s not the right one then change the number.

  16. Muhammad Saeed Javed on 26 Sep 2012:

    I want to redirect page after submitted form. I could find it in setting.
    Can you help me.

    Reply to Muhammad Saeed Javed

    • Graham on 26 Sep 2012:


      Not something you can do just yet but it’s easy to implement. If you can wait a day or two I’ll release a version when you have an option to redirect or show the thank you message.

      Update: redirectionsd now included in V4

  17. Bob Vance on 26 Sep 2012:

    Are there custom background colors available or is it only tan that I see?
    And can the size of the contact form be customized?

    Reply to Bob Vance

    • Graham on 26 Sep 2012:

      Hi Bob,

      The background colour is set in the plugin CSS. You can change this in the plugin editor. Add your background colours to #qcf-style.

      I’m working on an update at the moment and have been fiddling with selectable background colours and lots of other enhancements. That should be done in the next day or two.

      As to the size. Go to the ‘form settings’ tab and down the bottom is a width setting thing.

      Update: you can now set the background colour using the plugin settings

  18. Mkojne on 26 Sep 2012:

    Hello, first of all I would like to thank you, for the great and easy to use contact form 🙂

    I have an issue, and I don’t know if it’s related to the contact form or not. I hope, you could help me. The problem is – when user sends message, the copy that is send to e-mail doesn’t show some particular letters (website is in Lithuanian language). Where could be the root of the problem?

    Reply to Mkojne

    • Graham on 26 Sep 2012:

      Hi Mkonje,

      I’m not sure what the language problem is. All the validation does is remove HTML tags so the content should be exactly as it was sent. Can you use the form on this page and send me a message in Lithuanian so I can see the problem.

  19. Peter Bradley on 26 Sep 2012:

    Hmm. The simple sum doesn’t seem to work too well. I just installed quick contact on a client’s site and got a spam email from the form within a day.

    Could I suggest you use the PHP rand() function to create random numbers between 1 and 10 (or even 0 and 10) in qcf_display_form()? Of course you then have to pass the numbers generated back to qcf_verify_form() in order to check the answer is correct.

    But I like the form very much, apart from that. Thank you.

    Reply to Peter Bradley

    • Graham on 26 Sep 2012:

      Hi Peter, thanks for the suggestion.

      I’ve been struggling with the spam checker for a while. I found a great maths checker that uses random images but I just can’t get it to work. However none of them will stop the human spammer – only the bots.

  20. Jeffrey Driver on 24 Sep 2012:

    Thanks for the great plugin! All the others I’ve seen are needlessly complicated. Are you open to suggestions? I know that the beauty of this form is its simplicity but it would be great to see a reCAPTCHA option if possible, and to highlight a field that’s been incorrectly filled or have a permanent field label to help identify them.

    Reply to Jeffrey Driver

    • admin on 26 Sep 2012:

      Glad you like it. I’ve tried to make it simple to use as possible.

      I’ve added the maths captcha thingy as it’s far more usable and accessible than recaptcha but I don’t see a real problem with adding that options as well.

      As to the validation, the latest version does highlight which fields need sorting and (hopefully) tell you what needs to go there.

    • David Main on 04 Dec 2012:

      Hi Jeffrey,
      I was reading your submission to https://quick-plugins.com about the Quick Contact Form.
      You said . . . “Thanks for the great plugin! All the others I’ve seen are needlessly complicated. Are you open to suggestions? I know that the beauty of this form is its simplicity but it would be great to see a reCAPTCHA option if possible, and to highlight a field that’s been incorrectly filled or have a permanent field label to help identify them”

      It looks like a permanent field label has not been integrated. Just wondering if you came up with a solution . . .
      David Main

    • Graham on 12 Dec 2012:


      Recaptcha proved to be right pain in the bum to integrate. The maths spam blocker and all the other controls should block 99% of all known spammers. But I’ll have another look at this in the new year.


Add a comment
Your name
Your email