^$5/yr

Send Email from a Static HTML Form using Google Apps Mail!
Language : English | 한국어 | Español | Português
A Step-by-Step Example of using an HTML Form to send a “Contact Us” Message via Email without a Backend Server using a Google Script – No PHP, Python, Ruby, Java, Node.js etc.
See a working example here: https://dwyl.github.io/learn-to-send-email-via-google-script-html-no-server/
Note: With EU’s GDPR, we strongly advise researching recommendations on user privacy; you may be held responsible for the safekeeping of users’ personal data and should provide them a way to contact you.
Warning: Google’s API has limits on how many emails it can send in a day.
This may vary on your Google account, see the limits here.
We recommend implementing this tutorial through Part 3, since the data will
always be added to the spreadsheet first, then emailed if possible.
Why?
We needed a way of sending an email from a “static” HTML page
when you don’t (want to) have a server.
Key Advantages
No “Backend” to Deploy/Maintain/Pay for
Fully Customisable – every aspect is customisable!
Email sent via Google Mail which is Whitelisted Everywhere (high deliverability success)
Collect/Store any form data in a Spreadsheet for easy viewing
(perfect if you need to share it with non-technical people)
What?
Instead of using a server to send your email,
which is easy but requires maintenance,
use Google to send mail on your behalf
and use Google Spreadsheets to keep track of the data!

You could use a “free” service like http://formspree.io/ to process your form submissions
if you don’t care where you are sending your data and want to manage the data submitted
in your email inbox (messy … yuck!)
Or… you can invest a few minutes and keep data private/manageable.
Take your pick.

How?
1. Make a Copy of the Sample Spreadsheet

Sample: https://docs.google.com/spreadsheets/d/1Bn4m6iA_Xch1zzhNvo_6CoQWqOAgwwkOWJKC-phHx2Q/copy

Sign in to your Google account and click on “Make a copy…”

This should give you something like this:

Note: Feel free to change the name of the Copy to anything you want,
it will not affect the outcome.

2. Open the Script Editor
Open the Script editor… by clicking “Tools” > “Script editor…”

Here’s a snapshot of the script you need (at this point in the exercise): google-script-just-email.js
3. Set the TO_ADDRESS in the Script
Warning: If you do not uncomment and set your email as the value of
TO_ADDRESS, it is possible for someone who has web skills to alter your form
and send emailed data to an arbitrary email address.
This risk may not be very likely. Instead, if you wish, you can leave this
variable commented out if you accept this possible risk but want the added
convenience of setting this email variable inside your HTML form as a
data-email attribute. This allows you to easily change where to send emails
inside your HTML form without going back through steps 2-6. This functionality
does require you to use the provided JS file in Part Two, Step 10.
If you do not want to accept that potential risk, please uncomment the code for
the variable TO_ADDRESS, and set this value equal to the email which should
receive the form’s data when submitted.

4. Save a New Version of your Script
It’s not immediately obvious but you have to click on “Manage Versions…”

Then create your new version:

5. Publish the Updated Script as a Web App

Select the latest project version to deploy.
⚠️ Note: You must select the Anyone, even anonymous option for the ‘Who has access to the app’ dropdown or form responses will not be added to the spreadsheet! ⚠️

6. Authorize the Script to Send Emails

Unless you verify your script with Google, you will need to click on “Advanced” and “Go to … (unsafe)” to give this app permissions.

Copy the web app URL to your clip board / note pad.
Then Click “OK”.

7. Create your basic HTML Form
Using the template in index.html in this repo,
create your own html file with the basic form. (save the file)
⚠️ If you’re already trying to use your own form by this step rather than the example one in this repo:
Each of your form elements must have a name attribute equal to that of your column name in the Google sheet
The form’s class must be gform, i.e.

tags:

This will now display a “Thank You” message when the form is submitted:

Tailor your message by editing the thankyou_message div.
12. Use CSS to Make the Form Look Good
For this example we are using Pure CSS: http://purecss.io/start/
because its light weight (4.0KB minified and gzipped)
and solves our current “problem”: Making it Look Good.

Without spending too much time on this, we can make the form look
a lot nicer:

13. Make the email look good too!
By default, the sent email’s body contains the key-value pairs from the form, with the key as an

and the value as a

. This is a fairly basic, and foolproof view for the data.
You should get something that looks roughly like:

Bear in mind that this is a work in progress and does potentially open you up to getting more than you bargained for in the email. Because the email content is now looping over all the data sent in the form, if a robot or malicious user decides to POST more than you’ve asked for, you’ll likely get it in your inbox. Use with caution for now. We’re investigating improvements.

You can modify this though, via the script editor. The line:
result += “

” + key + “

” + obj[key] + “

“;
has all you need. You can adjust the markup to suit you. We chose an

because it was the best size for the email, and added the small amount of CSS to it to fix the capitalisation (the keys are all lower case in the JS object) and a bit of default spacing. While inline styles like this are generally bad practice on normal web pages, for email HTML they’re about the only reliable way to do CSS!
We went with a

for the value part, because it could be anything – single-line, multiline (a

for example wouldn’t cut it).
While we’re here, there’s also a replyTo option for the sendEmail() method which is commented out by default:
MailApp.sendEmail({
to: TO_ADDRESS,
subject: “Contact form submitted”,
// replyTo: String(mailData.email), // This is optional and reliant on your form actually collecting a field named `email`
htmlBody: formatMailBody(mailData)
});
You can uncomment that if you want to add a reply-to field to your email. The example in the script will set the reply-to as the email submitted in the form.
Google’s documentation provides more information about MailApp.sendEmail (for example cc/bcc etc.) if you’re interested:
https://developers.google.com/apps-script/reference/mail/mail-app
Part Three – Store Submitted Contact Form Data in a Spreadsheet
Sending the form data directly to your email inbox is a good
first step, but we can do better. Also, as noted above, Google
has limits on how many emails you can send in a day, so storing
the data into a spreadsheet is safer and less prone to data loss.
14. Add the record_data Function to your Google Apps Script

This will record the data received from the POST as a row in the spreadsheet.
See: google-apps-script.js for the full code you can copy-paste.
15. Save a New Version and Re-Publish it
Follow Steps 4, 5 & 6 to save a new version and re-publish the script.
16. Re-Test Submitting the Form

17 Confirm the Data was Inserted into the Spreadsheet

Live Server (on your localhost)
Because we are loading external .js files, our web browser
will not allow us to simply open the index.html from a
local directory for testing out the form.
Open your terminal and run this command
to install the node modules and start the live server:
npm install live-server –save-dev && node_modules/.bin/live-server –port=8000
It will take a minute to install,
but once that’s done your live-server will start up.
That starts a node.js HTTP server on port 8000
and opens the form you just created in your default browser.
If you wish to update the form styles in style.css or the
client-side Javascript in form-submission-handler.js,
please be sure to edit index.html to load those resources
locally rather than via GitHub.

Note: This is a light taste of Node.js for absolute beginners.
You do not need node.js to “deploy” this form,
you can run it on an any web server that serves HTML/CSS/JavaScript.
If you have never used Node.js before, see: http://nodeguide.com/beginner.html
but for the purposes of this exercise (submitting a form without a server)
you don’t need node.js or live-server
it’s just a nice thing to have when you are creating
your form because it automatically re-loads the page when you make changes in your text editor!

Want more?
If you want us to take this tutorial further, please let us know!
For your convenience, we have hosted a working demo of the field on GitHub
Pages, check it out to see the code and how it works:
https://dwyl.github.io/learn-to-send-email-via-google-script-html-no-server/
Add your own fields!
In response to Henry Beary’s request
we made the form handler generic which means you can now add any fields you want to the form.
We also created a form, test.html, which uses all kinds of form input elements
so you can just copy and paste elements as desired into your own form. Just be
sure to update their names and IDs. You can find a working example of this test
form here:
https://dwyl.github.io/learn-to-send-email-via-google-script-html-no-server/test.html
Remember to include the fields inside the form that has the class gform
and ensure that the name of the form element matches the new column heading in your spreadsheet.
e.g:

Favourite Color:

This will allow you to capture the person’s favourite color:
e.g:

Let us know if you have any questions!
Uploading Files
This resource may help you get started on uploading files to Google Drive from the Google Script.
Frequently Asked Questions (FAQ’s)
How can I get help using this tutorial?
Feel free to post an issue describing in detail which steps you have gone through and what isn’t working. To get a helpful response, please provide a working example that reproduces your issue. For example, see this sample CodePen.
Can I get edit access to the example spreadsheet?
No. This is being used to show a working example for anyone to copy, and an editable version could be broken accidentally, or maliciously, by any user.
Why is the webpage forwarding to a bunch of text when I hit submit?
You are not properly loading the required Javascript which submits the data via AJAX, or your browser does not support AJAX. Please see Part 2 and check your console logs in case you are finding errors.
Why is the webpage not successfully submitting the form?
Check your Javascript console logs. There could be an error while reading in the Javascript we have provided. There could be errors while submitting the form. It is required that your form have a class of gform, and also a data-email attribute if you have not set the TO_ADDRESS variable inside the Google Script file. Furthermore, the provided Javascript code also expects to see an email form element which it uses to check, a warning message for that element when an improper email is submitted, and then a thank-you div as well, which is shown after a form is successfully submitted. Please ensure that all of these HTML elements are in your form. See the sample file for code you can copy and paste. When you have all of these elements and a proper form set up, you should not see any error messages in your Javascript console when you hit submit.
The webpage is saying my data was submitted, but why isn’t my data being saved or sent to me?
When you copied the spreadsheet and published the Google Script, did you set the permissions to “Anyone, even Anonymous”? This is required for the form to work, since anyone on the internet can hit send to give you their data. Be sure that you have deployed the proper version of the script and used “Manage versions…” when making changes.
How do I change the emails this script sends?
You can tweak the Google Script on the server to send emails to anyone and in whatever format you wish. This could be used to send a confirmation email to those contacting you, but we have not added this feature to this tutorial to avoid potential spamming. The sender of the email will always be the Google account you use to create the form/script, however. Further details on how to customize the email can be found in the MailApp API. You can instead use the GmailApp API which may be more flexible for certain use-cases.
Is this secure? Can I use it for sensitive data?
No. While data that is sent over POST may be more protected, the information could easily be intercepted by a third party or middleman, and Google has complete access to the data inside a Google Spreadsheet. Email is also not a very secure communication medium by default. We would recommend you invest in a secure platform and server for storing your data if this is a requirement.
What if my data is sent or stored in the wrong order?
If your data is in the wrong order, it is recommended to verify that you are loading the clientside JS correctly. The most effective way to do this is to place a debugger call inside the handleFormSubmit() function, and, if it hits the debugger and opens the respective Dev Tools for the broswer/environment, then the clientside JS is being loaded correctly. If the debugger isn’t hit, then the JS is not either not loaded or not targeting your form, defaulting the data to a plain object which will have its own alphabetic ordering instead.
Background Reading
Google Apps Scripts Basics: https://developers.google.com/apps-script/articles
Logger (like console.log):
https://developers.google.com/apps-script/reference/base/logger
Simple Mail Merge using Google Spreadsheets:
https://developers.google.com/apps-script/articles/mail_merge
Original Tutorial: AJAX post to google spreadsheet: http://stackoverflow.com/questions/10000020/ajax-post-to-google-spreadsheet which points to:
https://mashe.hawksey.info/2011/10/google-spreadsheets-as-a-database-insert-with-apps-script-form-postget-submit-method/

Comments and Discussions

Reviews