FormThunder isn't open yet. This site describes the service as it will run at launch. Find out more

FormThunder
Menu

Add a Jekyll contact form with one include and no plugin

A Jekyll contact form needs one include and one value in _config.yml, with no plugin, so it runs on GitHub Pages too. Put the form in _includes, read the access key from site config with Liquid, and include it from any page. The form posts to FormThunder, which stores each submission and emails your verified address.

Updated

The Jekyll code

_config.yml
formthunder_key: YOUR_ACCESS_KEY
_includes/contact-form.html
<form action="https://formthunder.com/submit" method="POST">
  <input type="hidden" name="access_key" value="{{ site.formthunder_key }}">
  <input type="hidden" name="redirect" value="{{ '/thanks/' | absolute_url }}">
  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1">
  <label>Name <input name="name" required></label>
  <label>Email <input name="email" type="email" required></label>
  <label>Message <textarea name="message" required></textarea></label>
  <button type="submit">Send</button>
</form>
contact.md
---
layout: page
title: Contact
---

{% include contact-form.html %}

Replace YOUR_ACCESS_KEY with your free key. It's public by design, so it's safe in client code.

Notes for Jekyll

  • absolute_url uses url and baseurl from _config.yml, so set both or the redirect will point somewhere wrong in production.
  • Changes to _config.yml don't reload under jekyll serve. Restart it after adding the key.
  • Add sitemap: false to thanks.md if you use jekyll-sitemap, since a thank-you page has no reason to be in search.

Or have your AI add it

Connect the MCP server, then ask. The agent creates the form and writes the code for you, and it can send a real test when it's done.

You, to your AI
Add a FormThunder contact form to this Jekyll site that emails hello@example.com. Send a test when you're done.

Questions

Does this work on GitHub Pages?

Yes. It uses only core Liquid and no plugin, so GitHub's Jekyll build handles it.

Can I use it in a Minima theme?

Yes. Includes in your site's _includes folder are available to theme layouts and pages.

Get your Jekyll form sending

The free plan covers 250 submissions a month, with MCP, the CLI and the brand kit included.