Skip to content
Sign inJoin waitlist

Forms — Metuo HTML

The Metuo HTML template has one form, the booking form on Home, Service and Contact, and it sends to the form service or webhook of your choice.

The form checks the e-mail address before sending (and shows “Please enter a valid email address.” under it), shows a spinner while sending, says “Thank you” and clears the fields, keeps what the visitor typed when something fails (“Something went wrong”), and drops spam with a hidden honeypot field.

Out of the box it runs in demo mode: nothing is sent, and the fields are logged in the browser console. Pick a destination before you publish.

A static site has no server of its own, so submissions go to a form service or a webhook. All of these have a free tier:

Service What it does formEndpoint
Formspree Emails you each submission https://formspree.io/f/<form id>
Web3Forms Emails you each submission, no account needed https://api.web3forms.com/submit, and your key in formAccessKey
Getform, Basin Inbox, email, integrations The form’s endpoint URL
Zapier, Make, n8n, Pipedream Send submissions anywhere: Google Sheets, Slack, a CRM, your calendar or booking tool The webhook (“catch hook”) URL
  1. Create a form at the service and copy its endpoint.

  2. Open assets/js/config.js and paste it:

    window.siteConfig = {
    formEndpoint: "https://formspree.io/f/abcdwxyz",
    formAccessKey: "", // Web3Forms only
    };
  3. Serve the folder (npx serve .), send a request from the Contact page and check that it arrived.

  4. Upload config.js with the site.

Every page loads the same config.js, so the three copies of the form (Home, Service, Contact) send to the same place. The sample forms in style-guide.html stay in demo mode whatever you set there (they carry data-form-demo), so they never send anything.

Each field by its name, as multipart/form-data:

Field Name Required
First Name first-name
Last Name last-name
Email email yes
Phone phone
Preferred session type (checkboxes) service, once for every type ticked (the service’s name: Individual therapy, Life coaching …)
Preferred Date date (2026-11-03)
Preferred Time time (14:30)
What would you like support with? message

The form also sends form (book) and subject (“New session request”), so you can tell its messages apart in your inbox or tool. With formAccessKey set, it also sends it as access_key. The honeypot field is left out. The request asks for a JSON answer (Accept: application/json), so the service answers the page instead of showing its own thank-you page. A visitor who ticks two session types sends service twice: send yourself a test with two ticked to see how your service shows them.

The fields are ordinary <input> and <textarea> elements inside the <form data-form> of index.html, service.html and contact.html: change all three. Each field is a <label data-field="…"> with its label text in a <span> above the control, so the visible label is also the field’s name for screen readers:

<label data-field="phone" class="flex flex-col gap-2.5"
><span class="text-sm … text-grey">Phone</span
><input name="phone" placeholder="(+123)45678910" type="tel" autocomplete="tel" class="…"
/></label>

The fields sit two per row from tablets up (one column on phones); the session types and the message take the whole width (md:col-span-2), and the Submit button fills the first column under them.

  • To make a field required, add required to it. The form checks it before sending and focuses the first field that fails. To show a message under it, copy the e-mail’s <span id="email-error" data-field-error hidden …> into its <label> with a new id (phone-error) and your text.
  • To add a field, copy a <label data-field …>…</label>, give the control a new name and the label a new text. The service receives whatever the form contains, so there are no settings to update. Don’t name a field fax: it is the honeypot’s.
  • To change the session types, edit the checkboxes in the <fieldset> (“Preferred session type”): each one’s value (what you receive) and the <span> after it (what the visitor reads). Copy a <label> for one more.
  • To remove a field, delete its <label>.

The date and time fields show their empty state in grey (data-date-time data-empty): keep those attributes when you copy them. A field arrives under its name, so keep the names you already map somewhere. The button’s texts are written in the button: “Submit” twice (the second copy is read while the form is sending), “Thank you” and “Something went wrong”. “Thank you” and “Something went wrong” are also in the form’s data-success and data-error, which screen readers announce: change both. The title of each submission is the value of the hidden subject field: put your own wording in it.

To send visitors to a page of your own after a successful send, add data-redirect="thank-you.html" to the <form>.

  • Send a request from the live site with a real address, and reply to the test.
  • The service must answer with a success status (2xx). If it doesn’t, the visitor sees “Something went wrong” and keeps what they typed. Try it once by pasting a wrong endpoint into config.js on your local copy.
  • The browser console tells you what happened: in demo mode it logs [forms] demo mode — set formEndpoint in assets/js/config.js to send submissions with the fields; after a failure, [forms] could not send the form with the reason.

The honeypot stops the usual bots: the form carries a hidden field named fax that a person never sees; a bot that fills it is shown “Thank you” and nothing is sent. The services above filter spam on their side as well. The endpoint is visible in the page source, which is how these services are designed to work.

Submissions go only where you point them. Most countries expect you to say what happens to the data people send you (here a name, contact details, a preferred time and a message). People booking therapy or coaching may write about their health in the message, which many countries protect more strictly: choose a form service whose terms fit your obligations, and describe it in your privacy policy (legal/privacy-policy.html, a sample to rewrite). The form has no consent checkbox: add one as a required checkbox if your visitors need it.