Feedback Form for Hugo
Rating + free-text feedback with optional follow-up email. Free for 500 submissions per month — no backend, no SDK, no plugin.
Why Hugo developers choose splitforms for feedback form
Hugo's build speed is legendary, but Hugo sites are static HTML — there's no built-in mechanism to process form submissions. The traditional workaround is Netlify Forms (100 subs/month free) or a third-party API. The feedback form on this page posts directly from the browser to splitforms with zero Hugo configuration. It works in Hugo themes, shortcodes, and partial templates — just paste the HTML. Because Hugo's output is plain HTML, the form works on any host without a server-side component.
Yes — this is the shortest safe path for Hugo.
Use the HTML snippet on this page, keep the feedback form fields visible in your Hugo UI, and let splitforms handle delivery, spam filtering, storage, and webhooks.
Paste the HTML version, then replace YOUR_ACCESS_KEY.
The posted payload contains how would you rate your experience?, what can we do better?, email (optional, for follow-up). Required fields are how would you rate your experience? and what can we do better?.
Hugo is a static site generator — there's no runtime, no /server/api, no way to handle a form POST without an external service.
Customer feedback is the cheapest product research you have. The form captures NPS / CSAT plus an open comment — and routes negative responses to a Slack channel for same-day triage.
Built for Hugo developers who hate operating a backend.
Splitforms is the form backend for Hugo sites. One POST endpoint, no SDK, no plugin — drop the feedback form into a page and ship.
Splitforms is the form backend for Hugo sites. One POST endpoint, spam filtering, and a real dashboard — drop-in, no server, no PHP. Free for 500 dashboard submissions per month; Starter adds email, signed webhooks, exports, and retained uploads; Pro is $5/mo for 5,000.
- ✓500 form submissions per month
- ✓2 forms on Free; unlimited forms on Pro
- ✓Spam protection (honeypot + classifier)
- ✓Webhooks: Slack, Discord, WhatsApp, custom
- ✓CSV export of all submissions
- ✓Email notifications (CC and BCC on Pro)
Drop into any Hugo project.
Replace YOUR_ACCESS_KEY with your splitforms key, paste into a Hugo page, and ship. No build-time integration required.
Generate, embed, receive.
Three actions stand between you and your first feedback form submission. None of them require a backend, a database, or a CAPTCHA library.
Generate a free splitforms key
Sign in at splitforms.com — your access key is created instantly. No credit card, no setup wizard, no SDK to install.
Paste the feedback form into your Hugo project
Drop the form snippet into a Hugo page, component, or layout. Replace YOUR_ACCESS_KEY with the key from your dashboard. The form action is a hard-coded URL — no env vars or build-time wiring needed.
Receive submissions
Dashboard updates live on Free. Starter adds email delivery, signed webhooks, CSV export, Slack/Discord forwarding, and BCC to your team.
The reason this feedback form exists.
Webhooks into Slack / Linear / Productboard · NPS detractor triage in minutes.
Feedback forms cost almost nothing to ship and pay back disproportionately — every NPS detractor (score 0-6) is a conversation that prevents churn, every promoter (9-10) is a referral or testimonial source. The form is simple: 0-10 rating, an optional comment, and an email. The leverage is in the routing: detractors auto-DM your support lead in Slack within minutes, promoters get a 'mind leaving us a G2 / Trustpilot review?' follow-up, passives go into a digest. Survey tools (SurveyMonkey, Typeform, Hotjar) charge $30-100/mo for the same pattern. The form pattern is 30 lines of HTML.
Capture rating + comment
Required: 0-10 NPS rating (or 1-5 CSAT for transactional surveys). Optional: comment textarea, email for follow-up. Keep it minimal — long surveys tank completion.
Route by score
Webhook branches on score: 0-6 (detractors) DM Slack support channel; 7-8 (passives) go to weekly digest; 9-10 (promoters) trigger a G2 / Trustpilot review-request email.
Push to your tools
Detractor comments to Linear / Productboard for product triage. Promoter quotes to a 'testimonials' Notion database for marketing. Raw data to a CSV / BigQuery / dbt warehouse for trend analysis.
What changes when this feedback form lives in Hugo.
These notes come from the Hugo platform registry and are rendered on this template page so crawlers see the framework-specific answer without opening a separate guide.
Hugo is a static site generator — there's no runtime, no /server/api, no way to handle a form POST without an external service. The native paths are: (a) a Cloudflare Worker / Lambda / Cloud Run service handling POST /contact and emailing you (~4 hours of setup, ongoing operation), (b) Netlify Forms (Hugo-on-Netlify only, 100/mo free), or (c) a third-party form backend like Formspree, Basin, or Web3Forms. Hugo's templating shines for the form's HTML — {{ partial }}, {{ .Site.Params }} for the access key, {{< shortcode >}} for Markdown reuse — but the delivery layer is always external. Splitforms is the simplest external option that doesn't require a Cloud Run service.
Hugo deploys to any static host: Vercel, Netlify, Cloudflare Pages, GitHub Pages, S3, Surge, plain Apache/nginx. The form posts cross-origin so the host is irrelevant. Set splitformsKey in hugo.toml under [params] for private repos; for public repos, build with hugo --param splitformsKey=$SPLITFORMS_KEY and read it from CI env. Hugo's local dev server runs on localhost:1313 — add that to splitforms allowed-domains for testing or use a separate dev key. hugo --minify compresses HTML but doesn't touch attribute values — the form works under minification.
Site.Params lookup is case-sensitive in some Hugo versions
If you set splitformsKey in hugo.toml under [params] but reference it as {{ .Site.Params.SplitformsKey }} in the template, recent Hugo versions still resolve it — but Hugo 0.110 and earlier don't. Use the exact case from your config file.
Markdown content stripping eats inline form HTML
If you put a <form> directly in a Markdown content file, Goldmark's HTML sanitizer strips it. Either set markup.goldmark.renderer.unsafe = true in your config, or wrap the form in a shortcode (recommended): {{< contact-form >}}.
absURL filter on the redirect URL adds a trailing slash you don't want
{{ "thanks/" | absURL }} produces https://yoursite.com/thanks/. Hugo's URL filter normalizes trailing slashes per your uglyURLs config — if your /thanks page lives at /thanks.html (uglyURLs=true), the redirect 404s. Hardcode the URL or set relURL consistently.
Hugo modules / theme overrides require partial in your project, not the theme
If you copy contact-form.html into a vendored theme's layouts/partials/, your changes get overwritten on the next theme update. Always put custom partials in your project's own layouts/partials/ — Hugo's lookup chain prefers project over theme automatically.
Pattern A — partial in `layouts/partials/contact-form.html`
Reusable partial called from any template with {{ partial "contact-form.html" . }}. Pulls the access key from Site.Params.splitformsKey. Project-level partials override theme partials automatically. Use the same wiring for the feedback form fields on this page.
Pattern B — shortcode usable from Markdown content
Save as layouts/shortcodes/contact-form.html. Now writers can drop {{< contact-form >}} (with optional redirect="…" arg) directly into any .md file. Eliminates the need to switch to template editing for one-off forms. Use the same wiring for the feedback form fields on this page.
What every field actually does.
Each field below ships in the feedback form template — rename, remove, or add your own. Splitforms accepts any name you POST.
How would you rate your experience?
NPS / CSAT signal — quantitative complement to the comment field.
What can we do better?
Free-text input — no character limit, expands as the visitor types.
Email (optional, for follow-up)
Reply-to address — splitforms wires this so hitting reply goes back to the sender.
One backend. Every framework.
The same feedback form template works on every framework splitforms supports. Pick yours.
Feedback Form on Hugo — FAQ.
Direct answers, no marketing fluff. Missing one? Email hello@splitforms.com.
splitforms vs everything else.
Same drop-in API. More free submissions, Starter signed webhooks, MCP support no other backend has.
Other ready-to-ship Hugo forms.
Same backend, different qualifying fields. Click through to copy the snippet.
Ship a feedback form on Hugo in 60 seconds.
500 submissions per month, free forever. No credit card. Copy the snippet above and paste it into your Hugo project.