Skip to content

Integrating Jekyll and SmartForms and ReCaptcha For Static Site Contact Forms

Updated: at 11:18 PM


I’ve recently upgraded my blog site (this one) to use Jekyll instead of WordPress. For years, my Wordpress site has been getting more and more difficult to maintain. The MySql database is a mess from all the plugins, and every time I press the “Upgrade Site” button in my dashboard, my heart would sink a little until after it said “successfully updated”. I knew that if it failed, I’d be in a world of hurt.

So, I bit the bullet, spent about two days converting and learning Jekyll and now, my site is 100% converted, running on GitHub Pages and … so far so good. You can see the actually repository that serves the site here.…. When nice thing that came for free is I had been meaning to upgrade this site to https and with GitHub Pages, I just had to check a box to make that happen.

I did need to figure out the contact me form and that’s where SmartForms comes and made it easy

The Integration With SmartForms

Create an Account on SmartForms

Creating the account on was easy. No credit card, simple setup. Pricing is straight forward. 50 contacts emails a month, free forever. Though, I’d like to know what happens to that 51st.

Next, click on the button “My forms” and add a new form. You can see I have one now and it shows I have 10 submissions in it.

Clicking on my form, I just need to name it, give it a redirect URL which is what happens after the person entering the comment clicks send, and of course, a very important captcha secret needs to be entered.

I won’t go into the details, but getting the captcha keys is easy. Go to your google account (yes, you need a google account), go here:… and sign up for your keys (make sure to use recaptcha-2, 3 is hopefully coming… hint hint)

Save your site and secret keys in a secure place (everyone will see the site key, but the secret you shoud not share).

Now, go back to your form screen (above) and paste that secret key into the SmartForms setting box and update.

That’s it! You are ready to go to your Jekyll site and add your contact form.

The Contact Form in Jekyll

Just a couple things to do in Jekyll. First make a contact form that looks something like this:

title: Contact Me
description: How can I help you?
background: '/img/bg-contact.jpg'
form: true

{% highlight html %}

Want to get in touch? Fill out the form below to send me a message and I will get back to you as soon as possible!

{% endhighlight %}

Notice the script tag pointing to the google api and then just above the form tag at the bottom, the g-recaptcha div tag with my site key in it.

You are Done!

Now, when a user comes to your site and gets to the contact page, they see the nice google captcha and when they submit, you will get an email and the message will be logged.

Good luck with your Jekyll adventure!