LEAD MAGNET DOWNLOAD · HUGO

Lead Magnet Download for Hugo

Email-gated download form for ebooks, PDFs, checklists, and templates. Free for 1,000 submissions per month — no backend, no SDK, no plugin.

Get free access key Copy the code

1,000/mo free·no card·drop-in for Hugo

form.htmlhtml26 lines

01<form action="https://splitforms.com/api/submit" method="POST">
02  <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
03  <input type="hidden" name="subject" value="New lead magnet download">
04 
05  <label for="name">First name *</label>
06  <input id="name" type="text" name="name" placeholder="Jane" required>
07  <label for="email">Work email *</label>
08  <input id="email" type="email" name="email" placeholder="jane@company.com" required>
09  <label for="company">Company</label>
10  <input id="company" type="text" name="company" placeholder="Acme Inc">
11  <label for="role">What's your role?</label>
12  <select id="role" name="role">
13    <option value="">Choose…</option>
14    <option>Founder / CEO</option>
15    <option>Engineer</option>
16    <option>Designer</option>
17    <option>Marketer</option>
18    <option>Product manager</option>
19    <option>Other</option>
20  </select>
21 
22  <!-- honeypot — bots fill every field -->
23  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">
24 
25  <button type="submit">Send</button>
26</form>

1,000

submissions / mo, free

fields, ready to ship

code outputs

60s

from copy to inbox

§ 00Quick answerHTML · marketing

Yes — this is the shortest safe path for Hugo.

Use the HTML snippet on this page, keep the lead magnet download fields visible in your Hugo UI, and let splitforms handle delivery, spam filtering, storage, and webhooks.

best implementation

Paste the HTML version, then replace YOUR_ACCESS_KEY.

The posted payload contains first name, work email, company, what's your role?. Required fields are first name and work email.

native hugo reality

Hugo is a static site generator — there's no runtime, no /server/api, no way to handle a form POST without an external service.

use case fit

Ungated content gets read; gated content builds your list. The lead-magnet form trades the PDF for an email plus 1-2 qualifying questions, so the nurture sequence segments by intent.

§ 01Lead Magnet Download × Hugowhy this combination, in 80 words

Built for Hugo developers who hate operating a backend.

Splitforms is the form-to-email API for Hugo sites. One POST endpoint, no SDK, no plugin — drop the lead magnet download into a page and ship.

Splitforms is the form-to-email API for Hugo sites. One POST endpoint, spam filtering, signed webhooks, file uploads, a real dashboard — drop-in, no server, no PHP. Free for 1,000 submissions per month, $5/mo Pro for 5,000, $59 for 3 years if you hate recurring SaaS bills.

✦ what you get on the free plan

✓1,000 form submissions per month
✓Unlimited forms — one key, many pages
✓Spam protection (honeypot + classifier)
✓Webhooks: Slack, Discord, WhatsApp, custom
✓CSV export of all submissions
✓Email notifications (CC and BCC on Pro)

§ 02Copy-paste codeHTML · 26 lines

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.

form.htmlhtml26 lines

01<form action="https://splitforms.com/api/submit" method="POST">
02  <input type="hidden" name="access_key" value="YOUR_ACCESS_KEY">
03  <input type="hidden" name="subject" value="New lead magnet download">
04 
05  <label for="name">First name *</label>
06  <input id="name" type="text" name="name" placeholder="Jane" required>
07  <label for="email">Work email *</label>
08  <input id="email" type="email" name="email" placeholder="jane@company.com" required>
09  <label for="company">Company</label>
10  <input id="company" type="text" name="company" placeholder="Acme Inc">
11  <label for="role">What's your role?</label>
12  <select id="role" name="role">
13    <option value="">Choose…</option>
14    <option>Founder / CEO</option>
15    <option>Engineer</option>
16    <option>Designer</option>
17    <option>Marketer</option>
18    <option>Product manager</option>
19    <option>Other</option>
20  </select>
21 
22  <!-- honeypot — bots fill every field -->
23  <input type="checkbox" name="botcheck" style="display:none" tabindex="-1" autocomplete="off">
24 
25  <button type="submit">Send</button>
26</form>

§ 03Setup3 steps · 60 seconds · zero config

Generate, embed, receive.

Three actions stand between you and your first lead magnet download submission. None of them require a backend, a database, or a CAPTCHA library.

STEP 01GENERATE

Generate a free splitforms key

Create your form

key=sk_live_••••••••

STEP 02EMBED

Paste the lead magnet download 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.

snippethtml

<form action="https://splitforms.com/api/submit" method="POST">
  …
</form>

STEP 03RECEIVE

Receive submissions

Email arrives within seconds. Webhook fires in parallel. Dashboard updates live. CSV export, Slack/Discord forwarding, BCC to your team — all included free.

inbox · 1 newjust now

FROM contact@yoursite.com

New lead magnet download

Maya Iyer maya@studio71.co

Loved the demo — quick question about pricing on the 3-year plan. Are usage limits per project or account-wide?

§ 03bLead Magnet Download Form (Ebook / PDF / Checklist Gate)template-specific playbook

The reason this lead magnet download exists.

Multi-step (Typeform-style) · webhooks into ConvertKit / HubSpot / Mailchimp.

why it matters

Lead magnets — ebooks, checklists, templates, swipe files, mini-courses — are the workhorse of B2B content marketing. Gated downloads convert at 25-50% of landing-page visitors (vs 1-2% for newsletter signups), but only when the magnet is truly valuable. The form captures email plus 1-2 qualifying questions ('what's your role?', 'what's your team size?') so the nurture sequence segments by intent. Multi-step boosts completion vs a single form. After submit, the user is redirected to the PDF or it's emailed via webhook + auto-responder. Push the email to your ESP segmented by lead-magnet topic — that's how content marketers build audience taxonomies that actually convert downstream.

route the submission

Step 1: capture email

Single email field — frictionless step 1. Once the email is in, momentum carries through later qualifying questions.

Step 2-3: qualify role / team

One or two questions on role and team size. Optional but most users complete because they're invested. Each answer becomes a tag in the ESP for downstream segmentation.

Deliver the magnet

Auto-respond with the PDF link (or redirect to a thank-you page that auto-downloads). Webhook to ConvertKit / HubSpot / Mailchimp into a 'lead-magnet:[topic]' audience for the nurture sequence.

§ 03cHugo production notesnative path · deploy · gotchas

What changes when this lead magnet download 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.

without splitforms

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.

deploy notes

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.

Hugo gotcha

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.

Hugo gotcha

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

Hugo gotcha

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 gotcha

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

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 lead magnet download fields on this page.

pattern-a.htmlhtml8 lines

01{{/* layouts/partials/contact-form.html */}}
02<form action="https://splitforms.com/api/submit" method="POST">
03  <input type="hidden" name="access_key" value="{{ .Site.Params.splitformsKey }}" />
04  <input type="hidden" name="redirect"   value="{{ "thanks/" | absURL }}" />
05  <input name="email" type="email" required />
06  <textarea name="message" required></textarea>
07  <button type="submit">Send</button>
08</form>

PATTERN B

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 lead magnet download fields on this page.

pattern-b.htmlhtml9 lines

01{{/* layouts/shortcodes/contact-form.html */}}
02{{- $redirect := .Get "redirect" | default "/thanks/" -}}
03<form action="https://splitforms.com/api/submit" method="POST">
04  <input type="hidden" name="access_key" value="{{ .Site.Params.splitformsKey }}" />
05  <input type="hidden" name="redirect"   value="{{ $redirect | absURL }}" />
06  <input name="email" type="email" required />
07  <textarea name="message" required></textarea>
08  <button type="submit">Send</button>
09</form>

§ 04Field-by-field rundown4 fields · names you POST

What every field actually does.

Each field below ships in the lead magnet download template — rename, remove, or add your own. Splitforms accepts any name you POST.

nameREQUIRED

TEXT

First name

Greeting + dashboard label so submissions don't all read 'anonymous'.

placeholder · Jane

emailREQUIRED

Work email

Reply-to address — splitforms wires this so hitting reply goes back to the sender.

placeholder · jane@company.com

company

TEXT

Company

Lets you sort enterprise vs SMB inquiries before you reply.

placeholder · Acme Inc

role

SELECT

What's your role?

Buyer-persona signal — IC vs decision-maker changes the follow-up cadence.

Founder / CEOEngineerDesignerMarketerProduct managerOther

§ 05Lead Magnet Download on other frameworks21 frameworks · same backend

One backend. Every framework.

The same lead magnet download template works on every framework splitforms supports. Pick yours.

§ 06Questions9 answered

Lead Magnet Download on Hugo — FAQ.

Direct answers, no marketing fluff. Missing one? Email hello@splitforms.com.

01Does this lead magnet download work on Hugo?

Yes. The form is plain HTML with a single POST endpoint, so it runs on any Hugo site without server-side code, plugins, or SDKs. Drop the snippet into a Hugo page or component and submissions land in your inbox via splitforms.com.

02How much does the lead magnet download cost on Hugo?

Free for 1,000 submissions per month — no credit card, no trial. Pro is $5/mo for 5,000 submissions, and there's a one-time $59 3-year plan (15,000 submissions/mo for 36 months). The same pricing applies regardless of which framework hosts the form.

03Can I customize the fields?

Yes. The template ships with sensible defaults (first name, work email, company, what's your role?…) — add, remove, or rename any of them. Splitforms accepts whatever fields you POST.

04How does spam protection work on the lead magnet download?

A hidden honeypot field catches dumb bots, and a tuned classifier scores the rest. You only see real submissions in your dashboard. No CAPTCHA, no friction for human users — and it works the same on Hugo as on any other framework.

05Can I send the lead magnet download submissions to Slack or Discord?

Yes. Webhooks are free on every plan, with auto-formatted payloads for Slack, Discord, and WhatsApp (via CallMeBot). Or send raw signed JSON to any URL — Zapier, n8n, your own server. Configure in the splitforms dashboard.

06Will it work on a static Hugo site?

Yes — the form posts directly to splitforms from the browser, so no server is involved. Works on Vercel, Netlify, GitHub Pages, Cloudflare Pages, S3, or any plain Apache host.

07Should I redirect to the PDF or email it?

Email it. Redirects to a Drive / S3 link mean the user gets the PDF without confirming the email — and the email might be a typo or a temporary address. Email delivery confirms the address by requiring an open. Add a 'didn't get it?' resend button on the thank-you page for the rare typo case.

08Can I integrate with ConvertKit / HubSpot / Mailchimp?

Yes — webhook the JSON into the ESP. ConvertKit's 'tags' map naturally to lead-magnet topics; HubSpot's 'lists' do the same. The nurture sequence triggers on tag-add and the topic-specific drip starts immediately. Most B2B teams use this exact pattern.

09Is gating content GDPR-safe?

If you have EU visitors, the consent for marketing email needs to be explicit and unbundled — meaning a separate checkbox 'I want to receive emails about [topic]' that's not pre-checked and not bundled with 'I accept the download'. Bundled consent has been challenged in EU rulings; unbundled is the safe play.

§ 07Comparisonvs Web3Forms · vs Formspree

splitforms vs everything else.

Same drop-in API. More free submissions, real webhooks on the free tier, MCP support no other backend has.

Feature	Web3Forms	Formspree	splitforms
Free monthly submissions	250	50	1,000
Custom fields beyond contact	Yes	Pro tier	Free
Webhooks (Slack / Discord)	Pro tier	Pro tier	Free, signed
AI / MCP submission inbox	No	No	Yes
Long-term plan (3-year flat)	—	—	$59 every 3 years

§ 08More templates for Hugo5 adjacent patterns

Ship a lead magnet download on Hugo in 60 seconds.

1,000 submissions per month, free forever. No credit card. Copy the snippet above and paste it into your Hugo project.

Get free access key →Read the docs

founders pricing locked in · early access open

Lead Magnet Download for Hugo

Yes — this is the shortest safe path for Hugo.

Paste the HTML version, then replace YOUR_ACCESS_KEY.

Built for Hugo developers who hate operating a backend.

Drop into any Hugo project.

Generate, embed, receive.

Generate a free splitforms key

Paste the lead magnet download into your Hugo project

Receive submissions

The reason this lead magnet download exists.

Step 1: capture email

Step 2-3: qualify role / team

Deliver the magnet

What changes when this lead magnet download lives in Hugo.

Site.Params lookup is case-sensitive in some Hugo versions

Markdown content stripping eats inline form HTML

absURL filter on the redirect URL adds a trailing slash you don't want

Hugo modules / theme overrides require partial in your project, not the theme

Pattern A — partial in `layouts/partials/contact-form.html`

Pattern B — shortcode usable from Markdown content

What every field actually does.

First name

Work email

Company

What's your role?

One backend. Every framework.

Lead Magnet Download on Hugo — FAQ.

splitforms vs everything else.

Other ready-to-ship Hugo forms.

Ship a lead magnet download on Hugo in 60 seconds.