NisuformDocs

HTML forms

Connect a plain HTML form to Nisuform with the action attribute, without JavaScript, a server or a build step.

Any HTML form can send submissions to Nisuform. Set the form's action to your endpoint and its method to POST.

<form action="https://api.nisuform.com/s/YOUR_FORM_KEY" method="POST">
  <label for="name">Name</label>
  <input id="name" type="text" name="name" required>

  <label for="email">Email</label>
  <input id="email" type="email" name="email" required>

  <label for="message">Message</label>
  <textarea id="message" name="message" rows="5" required></textarea>

  <input type="text" name="_gotcha" tabindex="-1" autocomplete="off" style="display:none">
  <button type="submit">Send</button>
</form>

Copy your endpoint from the form's Setup tab, or from Settings, Endpoint.

For ready-made markup, start from a form template. To compare this with the other ways to run a form on a static site, read how to add a contact form to a static website.

Name every field

The browser only sends inputs that have a name. The name becomes the key the answer is saved under, and the inbox shows it as the label unless the field has a label in the form builder.

  • If your form has fields in the form builder, use the same names so Nisuform can validate the answers. The Field name of each field is shown in the builder.
  • Inputs that the builder does not list are still saved as they are.
  • Names that start with an underscore, like _gotcha, control how Nisuform handles the submission and are not saved. See Special fields.

Multiple values

Checkboxes that share a name, and names that end in [], are saved as one comma-separated answer:

<fieldset>
  <legend>Topics</legend>
  <label><input type="checkbox" name="topics[]" value="Design"> Design</label>
  <label><input type="checkbox" name="topics[]" value="Development"> Development</label>
  <label><input type="checkbox" name="topics[]" value="Marketing"> Marketing</label>
</fieldset>

Checking the first two saves topics as Design, Development.

Hidden fields

Use hidden inputs to record where a submission came from. They are saved like any other field:

<input type="hidden" name="source" value="pricing-page">
<input type="hidden" name="plan" value="team">

Nisuform also records the page the form was sent from on its own. The inbox shows it as Page on every submission.

What visitors see

After a normal browser submit, Nisuform answers with a thank-you page that links back to the page the visitor came from. On Pro you can replace it with your own title and message or redirect to a page on your site. See Thank-you page and redirects.

If a submission is rejected, for example because the form is closed or the visitor sent too many requests, the visitor sees a short page that explains why, with a link back to your site.

File inputs

To accept files, the form needs enctype="multipart/form-data" and file uploads must be turned on for the form. Uploads are a Pro feature. See File uploads.

Sizes and limits

  • Up to 50 fields per submission. Extra fields are ignored.
  • Field names up to 200 characters.
  • Values up to 10,000 characters. Longer values are cut at 10,000.
  • The whole request can be up to 200 KB, or 25 MB on forms that accept file uploads.

Opening the endpoint in a browser

The endpoint only accepts POST. If you open it in a browser tab you see a short page that explains it is a form endpoint, with status 405. That is expected.