# Add a contact form to a Jekyll site

> A Jekyll contact form from one prompt or one include, form ID in _config.yml.

Last updated 2026-11-20. Web version: https://wrenform.com/docs/guides/contact-form-jekyll

```text
Add a working contact form to this Jekyll site. Create the form by sending POST https://wrenform.com/api/v1/quick-forms with JSON {"email": "YOUR_EMAIL", "framework": "jekyll"} (if you can't make HTTP requests, give me the curl command to run). Put the returned snippet on a /contact page or section, matching the site's style: a label for each field, type="email" on the email field, and keep the _honey field exactly as returned. Show a thank-you message after sending and an error message on failure. Put the form in _includes/contact-form.html and the form ID in _config.yml as wrenform_id, and include it from a contact page. No plugin. Add no dependencies, API keys or server code. Then tell me to check my inbox for the Wrenform email and click Confirm, because messages are held until I do.
```

Replace `YOUR_EMAIL` with the address that should get the messages, and paste. This creates a [form without an account](/docs/quick-forms): no sign-up, no mail provider, free for 250 submissions a month. Nothing is forwarded until you click **Confirm** in the email we send, and unconfirmed forms are deleted after 7 days. Prefer the dashboard? [Create a form](/sign-in) and use the snippet below.

Jekyll builds static HTML, so there is no server to receive a form, and GitHub Pages runs no plugins. Wrenform is the HTTPS endpoint the form posts to; the form ID is public, so it can sit in `_config.yml`.

## Steps

1. Paste the prompt into your coding tool, or add the include below by hand.
2. Add `wrenform_id: YOUR_FORM_ID` to `_config.yml`, with your form ID.
3. Add `{% include contact-form.html %}` to your contact page.
4. Click **Confirm** in the email from Wrenform, then deploy.

**Lock the form to your site.** A form created this way accepts posts from any site. Once you've confirmed, [sign in](/sign-in) with the same address and add your published domain under **Allowed origins** in the form's settings, for example `https://example.com`.

## Or paste the code

```liquid
{% comment %} _includes/contact-form.html
   In _config.yml:  wrenform_id: YOUR_FORM_ID {% endcomment %}
<form action="https://wrenform.com/f/{{ site.wrenform_id }}" method="POST">
  <label>Name <input type="text" name="name" autocomplete="name" required></label>
  <label>Email <input type="email" name="email" autocomplete="email" required></label>
  <label>Message <textarea name="message" required></textarea></label>
  <input type="text" name="_honey" style="display:none" tabindex="-1" autocomplete="off">
  <button type="submit">Send</button>
</form>
```

Save it as `_includes/contact-form.html`. It is a plain HTML form, so it needs no JavaScript and works on GitHub Pages as is. To send visitors to your own page after sending, set **Redirect to** in the form's settings (see [redirects](/docs/redirects)).

## Spam and email

- The hidden `_honey` field catches most bots. Keep it in the form, hidden, with `autocomplete="off"`.
- A timing check marks submissions sent less than 3 seconds after the form loaded as spam, when the form sends the timing field. The optional script in the HTML snippet adds it; see [the timing field](/docs/spam#the-timing-field). No captcha is needed.
- Each real submission is emailed to you and shown in your dashboard. If a field is missing from the email, check that its input has a `name` and isn't disabled.
- Submissions are stored in the EU. Free keeps them for 30 days, paid plans for 365 days.

## Test it

Run `bundle exec jekyll serve`, open the contact page and send the form. After confirming, the message is in your inbox and your dashboard. Send one more from the deployed site.

## Common problems

- **The form sends but no email arrives.** The address hasn't confirmed yet. Look for the email from Wrenform, also in spam.
- **`403 origin_not_allowed`.** The page's origin isn't in the form's **Allowed origins**. Add it, including any preview domain you test from. See [errors](/docs/errors#origin_not_allowed).
- **The action URL ends in `/f/`.** `wrenform_id` is missing from `_config.yml`, or the server wasn't restarted: Jekyll doesn't reload `_config.yml` on its own.
- **Anything else.** See [troubleshooting](/docs/troubleshooting).

## Next steps

- [Jekyll guide](/docs/frameworks/jekyll): a thank-you page and the full include.
- [GitHub Pages](/docs/hosting/github-pages): allowed origins for `github.io` sites.
- [Prompts for AI builders](/docs/ai): the same prompt for other tools.
- [Pricing](/pricing): free for 250 submissions a month, paid plans from €5.
