# Add a contact form to a Hugo site

> A Hugo contact form from one prompt or one partial, with spam filtered.

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

```text
Add a working contact form to this Hugo site. Create the form by sending POST https://wrenform.com/api/v1/quick-forms with JSON {"email": "YOUR_EMAIL", "framework": "hugo"} (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 a partial and the form ID in hugo.toml under [params] as wrenformId. 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.

Hugo builds static HTML, so there is no server to receive a form. Wrenform is the HTTPS endpoint the form posts to; the form ID is public, so it can sit in your config.

## Steps

1. Paste the prompt into your coding tool, or add the partial below by hand.
2. Set `wrenformId` under `[params]` in `hugo.toml`.
3. Call the partial from your contact page template.
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

```html
{{/* layouts/partials/contact-form.html
     In hugo.toml:  [params]  wrenformId = "YOUR_FORM_ID" */}}
<form action="https://wrenform.com/f/{{ site.Params.wrenformId }}" method="POST">
  <input type="text" name="name" required>
  <input type="email" name="email" required>
  <textarea name="message" required></textarea>
  <input type="text" name="_honey" style="display:none" tabindex="-1" autocomplete="off">
  <button type="submit">Send</button>
</form>
```

Save it as `layouts/partials/contact-form.html` and call it with `{{ partial "contact-form.html" . }}`.

## 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.

## Test it

Run `hugo server`, 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/`.** `wrenformId` isn't set under `[params]` in `hugo.toml`.
- **Anything else.** See [troubleshooting](/docs/troubleshooting).

## Next steps

- [Hugo guide](/docs/frameworks/hugo): shortcodes and a thank-you page.
- [Prompts for AI builders](/docs/ai): the same prompt for other tools.
- [Pricing](/pricing): free for 250 submissions a month, paid plans from €5.
