Overview

Unlock the power of your emails with schema.org

Email is an important part of how we get things done. Whether you want toplan an event with friends or organize a business trip to Paris, you areprobably using email to assist with the task. By addingschema.org markup to the emails you send yourusers, you can make that information available across their Google experience,and make it easy for users to take quick actions, such aschecking in for a flight. Gmail, Google Calendar, Google Search,and the Google app all already use this structured data.

Schema.org is a markup vocabulary that is standardizedand managed as a collaboration of Google and other companies. By working withschema.org, we are creating an open standard, so that the markup you embed canbe used by any email product that receives them.

See the video for more motivation and similar examples of why you shouldconsider email markup for your app.

Note: Some of the schemas used by Google are still going through the standardization process ofschema.org, and therefore, may change in the future.Learn More.

Gmail Actions

Gmail uses schema.org markup to accelerate user actions and tohighlight the most important information users need from an email.

Gmail supports the following types of actions and interactivecards:

Gmail Highlights

Gmail uses the same schema.org markup to highlight the mostimportant information within an email, and allow user to act on it.

Gmail Promotions tab

The Promotions tab puts the most valuable parts of email right at users'fingertips. Here are some highlights:

  • The most valuable email is pulled to the top using machinelearning.
  • Bundles help organize top deals and topics.
  • Image previews showcase the most vibrant part of the message.
  • Deal badges highlight expiring and valuable deals.

Rich email previews can lead to more engaged customers. Control whatis richly previewed by annotating your images, expiration dates, anddeals within email.

For more information, refer toGmail Promotions tab.

Google Calendar

With "Events from Gmail", Google Calendar extracts events frombooking confirmation emails such as Flight, Concert, Restaurant reservation orany other ticketed events and adds them to Calendarautomatically.

Google Calendar supports following 4 types of mark-up types:

By adding markup to your emails, you get your events automatically added touser's Calendar with all the important information.

For more information, refer toAuto added Events in Google Calendar.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-12-11 UTC.