Does Google provide any documented, official recommendations about how to format an email that will easily import the event into a user's Google Calendar?

Let's say that I want to send an email about an event to a Gmail user. I might be sending this email using Outlook, Gmail, mailx, etc. The recipients are using Gmail.

I know this email can be formatted in a way so that Gmail can easily import this event into Google Calendar. Google describes this feature at Automatic event recognition in Gmail, and at Help articles › Access options › Other Google products › Gmail.

However, this feature doesn't always work.

I've tried many different formats, placed different text in different email bodies, in the subject line, etc. Sometimes they work, sometimes and don't.

  • Sometimes there is a "Add to Calendar" link on the right side of the Gmail page.
  • I can also go to the menu "More: Create Event". This will bring me to a Google Calendar page to create the event. Sometimes the fields are automatically populated with information from the email, but often these fields are all blank.

Here are some examples:

One with a location and day:

Meet me at the circus this Thursday

Date, time and location:

Meet me at the Circus at 2198 University Ave, Berkeley, CA on Aug 10, 2011 at 3:00PM

Event, date and location labelled as such:

What: Meet at the Circus
Where: 2198 University Ave, Berkeley, CA
When: Aug 10, 2011 at 3:00PM

Are there any recommendations or guidelines about how to format these emails so that they are automatically recognized by Google Calendar?

Is there a difference between 'normal' Gmail vs. Google Apps?

  • I have a feeling its not working anymore. I use to see the option to create events based on the contents of an email which worked really well but I no longer see the option...
    – OrangeBox
    Commented May 3, 2012 at 6:56
  • @OrangeBox : The "Add to Calendar" button works for me, but the "More: Create event" does not. Commented May 7, 2012 at 4:06

4 Answers 4


I have had limited success with the following format:

Subject: My test event

Email body says:

This is my test event!

When: May 7, 9-10AM
Where: 123 Main Street, Berkeley, CA

Using the keyword "Location" instead of "Where" seems to work also.

In Google Calendar, this will populate the Subject, the body and the event time and the event location (The field labeled "Where").

I have been using the above format with my personal Gmail account, and my institution's Google Apps account. It usually works with the "Add to Calendar" button, and with the "More: Create event" menu option.

  • 3
    Nice to see you coming back with your results many months after! Commented May 7, 2012 at 16:35

Apparently the automatic-adding is controlled by a markup schema embedded into the source code of the e-mail:


Cribbing from that, try something like this?

<script type="application/ld+json">
  "@context": "http://schema.org",
  "@type": "EventReservation",
  "reservationNumber": "E123456789",
  "reservationStatus": "http://schema.org/Confirmed",
  "underName": {
    "@type": "Person",
    "name": "John Smith"
  "reservationFor": {
    "@type": "Event",
    "name": "Meet at the Circus",
    "startDate": "2011-08-10T15:00:00-16:00",
    "location": {
      "@type": "Place",
      "name": "2198 University Ave",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "2198 University Ave",
        "addressLocality": "Berkeley",
        "addressRegion": "CA",
        "addressCountry": "US"
  • Personally, I think this is the best answer now
    – Kevin M
    Commented Nov 7, 2017 at 16:27

There is no way. The "Create Event" button just fills the description of a new event with the body of the email and the title is filled with the subject of the email.

I personally have never seen my events be filled automatically other then that.

  • I can fill subject, description, event start and end times, and the location by using certain keywords in the email. Google is working on this, and it has changed in the last 6 months. Commented May 7, 2012 at 3:58
  • @StefanLasiewski Interesting I could not get it to fill it using your templates. Maybe they are still working on it then and slowly rolling new features out. Commented May 7, 2012 at 16:34
  • Looks like my template doesn't work with 'Create Event', but it does work with the 'Add to Calendar' button. However, 'Add to Calendar' only appears on some screens. It seems that Google has two features which perform similar functions. Commented May 7, 2012 at 18:33
  • And yes, Google does roll out features to different groups of users at different times. I think we have all seen that. Commented May 7, 2012 at 18:34
  • Well not, much that we can do now to solve this further as it seems to be more of an internal issue. If you really want try to get in contact with Sarah (Link). She is the community manager for GMail. Commented May 7, 2012 at 19:37

If I put the subject for the calendar event into the subject of the email exactly how I want it to look, that will populate. I just tested it. In the body of the email, I typed "Date: month spelled out, number, full year" and that will populate and Google will recognize it and add those dashes under it.

If you do abbreviated month, or don't add a year, it won't recognize it. Also, Time: 9am will populate, BUT--

A) You have to "add to calendar" by clicking on the time in the email. If you only click the date to "add to calender" it won't recognize the time and you'll have to add it in manually in the pop up screen.

B) If you do click the time to add, it will not auto-add an end time (normally when you create event in Calendar it will auto default to preset length of time).

Conversely, just clicking the date and not entering a time will add it as an all day event bar.

I still haven't figured out how to get location to populate. Where: and Location: with a full address doesn't see to work.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.