Submissions

Once you have created a form any field that you include in your form will be submitted directly to your Jamform endpoint. It is important that each field has a unique name attribute since that is the value that will be used for the field name.

Example:

The code block below has three input fields, email, name, and address.

<form action="https://jamform.com/f/{formId}" method="POST">
  <input type="email" name="email" />
  <input type="text" name="name" />
  <input type="text" name="address" />
  <button type="submit">Send</button>
</form>

A submission to this form will be displayed like this on your form dashboard with the fields 'email', 'name', and 'address'.

Special Field Types

Most input types will be submitted and displayed as you would expect, type="text" will submit a string value, type="number" will submit a number value, etc. However, some types may not behave as expected.

Form Checkboxes

Checkboxes can be used in forms where you need a user to select one or more options. When you use a checkbox with a Jamform form, you need to set the value attribute on the field as well as the name.

Example:

The code block below has a checkbox with the name 'newsletter' and the value 'subscribe'.

<form action="https://jamform.com/f/{formId}" method="POST">
  <input type="checkbox" name="newsletter" value="subscribe">
  <button type="submit">Send</button>
</form>

A submission to this form will be displayed like this on your form dashboard.

If instead you leave off the value attribute like the code snippet below.

<form action="https://jamform.com/f/{formId}" method="POST">
  <input type="checkbox" name="newsletter">
  <button type="submit">Send</button>
</form>

Your value will simply show up as 'on', may not be desirable.

It is also important to note that if a checkbox is not checked it's value will not be included in your form submission at all.

Form Arrays and Objects

Sometimes you may want to submit multiple values in a single field. Forms allow you to submit multiple values in an array using bracket notation.

Example:

The code block below has three inputs with the name 'toppings[]' allowing you to submit up to three different toppings with your form submission.

<form action="https://jamform.com/f/{formId}" method="POST">
  <input type="text" name="toppings[]">
  <input type="text" name="toppings[]">
  <input type="text" name="toppings[]">
  <button type="submit">Send</button>
</form>

When you make a submission to this form the array will be "stringified" and displayed in a single field with the name 'toppings'.

Objects are not inherently supported by forms, however, if you submit an object to your Jamform endpoint via an AJAX call or other means, it will also be stringified and displayed similarly.

Limitations:

There are a few limitations to the submissions Jamform will accept. First, each submission can only contain up to 100 fields. Also, your submission (files excluded) can only be up to 100 KB in size. Finally, accounts are limited to the number of submissions a form can accept, be sure to check your form's limitations and delete submissions or upgrade your account if necessary.