Basic Usage

    You create a form and point it to your Form Sparrow url.
    If this is the first time a form is submitted for the specified email address (or email ID), a verification email is sent to the email address. This email contains a link which the owner has to click to verify the email address. After loading the URL, the user will see a confirmation message saying the email address is now ready to receive form data.
    From now on, every form submitted for the specified email address (or email ID) will result in an email containing the form data being emailed to the specified email address.

For Form Sparrow to function properly, it's important you submit your form data as POST data, rather than GET data. To achieve this, add the following attribute to your opening form tag method="POST". A proper opening form tag would look something like this:

<form action="//" method="post">

Email address or email ID
Form Sparrow allows you to submit directly to an email address, or instead of using your email address, use an email ID instead. This email ID is simply a unique string which Form Sparrow recognises as being linked to your email address. By using an email ID instead of a regular email address, you prevent your email address being embedded in the form markup and therefor out of hands of bots crawling the web to harvest email addresses. Creating an email ID is very simple. Once Form Sparrow is installed, navigate to your Setup/Login page and enter your email address. Click the blue button and the software will display your email ID, together with the entire Form Sparrow url to setup with your form. This email ID remains the same, so whenever you've lost it, simply enter it again on the Setup/Login page and the software will show it again.
Basic usage with regular email address:

<form action="//" method="post">   <input type="text" name="name">   <input type="email" name="email">   <textarea name="message"></textarea>   <input type="submit" value="Send"></form>

Basic usage with email ID:

<form action="//" method="post">    <input type="text" name="name">    <input type="email" name="email">    <textarea name="message"></textarea>    <input type="submit" value="Send"></form>

Advanced Usage

To get more advanced usage from Form Sparrow, you can use several special form fields:

Custom subject
Sets a custom subject for the email sent by Form Sparrow

<input type="hidden" name="_subject" value="My awesome subject">

Custom reply to
Sets a custom reply to value for the email sent by Form Sparrow

<input type="hidden" name="_replyto" value="moc.liamg%40eodnhoj">

Instead of specifying a static custom "reply to" address, you can also choose to use an email address entered by the user of the form. In order to do this, give your custom "replyto_" field a value of "%" followed by the name of the field. Let's assume you have a field named "email" which value you'd like to use for your custom "reply to" field, then you'd give you "reply to" field a value of "%email".

<input type="hidden" name="_replyto" value="%email">

Allows you to specify a URL to redirect the user to after successfully submitting the form and sending out the email

<input type="hidden" name="_after" value="">

Honey pot
The honey pot field adds an additional spam protection to your forms. By inserting this hidden field, you're allowing Form Sparrow to detect automated submissions. If Form Sparrow fields a value inserted into the honey pot field, this is a strong indication that the submission as automated and it will be marked as spam. Please note that the "value" attribute of this field must remain empty.

<input type="text" name="_honey" value="" style="display:none">

Custom confirmation message for the user
This form allows you specify a custom confirmation message which is shown to the user after submitting the form. Setting this field overrides the default confirmation message.

<input type="hidden" name="_confirmation" value="<b>Thank you!</b> We have received your message and will get back to you asap.">

CC and BCC recipientsUse the following syntax to specify one or more CC and/or BCC recipients. Please note the name of this field is "cc[]" or "bcc[]". This allows you to specify any number of entries, rather than just one.

<input type="hidden" name="cc[]" value="moc.liamg%40eodnhoj"><input type="hidden" name="bcc[]" value="moc.liamg%40eodenaj">

Form Data Validation

Form Sparrow comes with built-in form validating capabilities. You can specify a variety of rules for your data; and if the submission does not pass the validation process, the user will be shown a message detailing which validation rules were not passed.

Validation syntax
The validation syntax is simply and straightforward. You simply add a hidden field for each form field you'd like validated, and you name this hidden field "_valid[field_name]" where you replace "field_name" with the name of the field. Please see the basic example below:

<form action=""//" method="post">    <input type="hidden" name="_valid[name]" value="required">    <input type="hidden" name="_valid[email]" value="required|valid_email">    <input type="hidden" name="_valid[message]" value="required">    <input type="text" name="name">    <input type="email" name="email">    <textarea name="message"></textarea>    <input type="submit" value="Send"></form>

In the example above, the form contains three fields to be filled out by the user: name, email and message. Accordingly, three hidden validation fields have been added to the form as well. The "name" field must validate as required, meaning it can not be left empty. The same applies to the "message" field. The "email" field is also required, and in addition it must validate as a proper email address. If any of these requirements are not met, the user will get an error message explaining what is wrong with their data.


Form Sparrow is capable of handling forms with file uploads with a breeze. Simply include a file input element in your form, make sure to add "enctype=multipart/formdata" to the form wrapper and to set the "name" attribute to file and you're all set!
Below you'll see an example of a form with a file input element:

<form enctype="multipart/form-data" action=""//" method="post">    <input type="text" name="name">    <input type="email" name="email">    <textarea name="message"></textarea>    <input type="file" name="file">    <input type="submit" value="Send"></form>

Webflow Usage

Form Sparrow is super simple to add to Webflow due to the intuitive user interface Webflow has. Below is a quick tutorial on how it's achieved.
Start by navigating to your form settings in Webflow:

    Next, copy the Action URL generated by Form Sparrow and paste it in to the Action field provided.
    Then, go ahead and change the Method from Get to Post
    If you'l like to add the ability to accept an Attachment, add the custom attribute as follows: enctype = "multipart/form-data"

And simply add <input type="file" name="file"> using the Embed element in Webflow:


Once the above is done, publish your changes and you're all set and ready!