NPS survey template

03 / Make it yours

Choose your stack. Copy your form.

Replace the example endpoint with your Formward endpoint, then adapt the fields to your needs.

<form action="https://forms.formward.eu/f/your-form-id" method="POST">
  <label for="email">Email</label>
  <input type="email" name="email" id="email" />
  <label for="score">How likely are you to recommend us? (0-10)</label>
  <input type="number" name="score" id="score" required />
  <label for="reason">What is the main reason for your score?</label>
  <textarea name="reason" id="reason"></textarea>
  <input type="text" name="_gotcha" tabindex="-1" autocomplete="off" style="position:absolute;left:-9999px" aria-hidden="true" />
  <button type="submit">Send</button>
</form>

Accessibility

Accessible by default, and how to keep it that way

• Every field in the code has a visible label tied to it with for and id, so screen readers announce what to enter and a click on the label focuses the field.
• Required fields carry the required attribute, so the browser explains a missing answer before anything is sent. Say “required” in words as well; an asterisk or a colour alone is easy to miss.
• The spam trap field (_gotcha) is hidden from screen readers with aria-hidden and skipped by the Tab key, so people never meet it.
• In the JavaScript versions, show the confirmation or error in an element with role="status" so the result is announced, and keep the entered answers when sending fails.

Changed the fields? Paste your version into the HTML form tester to see exactly what it sends, or run it through the GDPR form checker.

04 / Implementation

How the code talks to Formward

Next.js client component

Copy"use client";

import { useState } from "react";

export function NpsSurveyForm() {
  const [sent, setSent] = useState(false);

  async function onSubmit(e: React.FormEvent<HTMLFormElement>) {
    e.preventDefault();
    const form = e.currentTarget;
    const res = await fetch("https://forms.formward.eu/f/your-form-id", {
      method: "POST",
      headers: { Accept: "application/json" },
      body: new FormData(form),
    });
    if (res.ok) {
      setSent(true);
      form.reset();
    }
  }

  if (sent) return <p>Thanks! Your message has been sent.</p>;

  return (
    <form onSubmit={onSubmit}>
      <label htmlFor="email">Email</label>
      <input type="email" name="email" id="email" />
      <label htmlFor="score">How likely are you to recommend us? (0-10)</label>
      <input type="number" name="score" id="score" required />
      <label htmlFor="reason">What is the main reason for your score?</label>
      <textarea name="reason" id="reason" />
      <input
        type="text"
        name="_gotcha"
        tabIndex={-1}
        autoComplete="off"
        style={{ position: "absolute", left: "-9999px" }}
        aria-hidden="true"
      />
      <button type="submit">Send</button>
    </form>
  );
}

Questions

How do I calculate NPS from the responses?

Count scores of 9 and 10 as promoters and 0 to 6 as detractors. NPS is the percentage of promoters minus the percentage of detractors, a number between minus 100 and 100.

Why does the hosted NPS template use a 1 to 5 scale?

Hosted forms render ratings on a 1 to 5 scale. If you need a true 0 to 10 NPS, use this code template on your own site, where the score is a number field.

Related

• Feedback templates

  Satisfaction, complaints, course and event feedback.

• Customer satisfaction survey

  When you want to know what to fix.

• Online forms without a website

  Share a survey as a link.

• Next.js forms

  Embed the survey in your app.