Alternate Runtimes for Google Workspace Add-ons is coming soon. Learn more.

Add-on types

This page provides a general overview of the two types of add-ons you can build: Google Workspace Add-ons and Editor Add-ons. These add-on types differ in what applications they extend, how they are created, and what restrictions they have.

Google Workspace Add-ons

Google Workspace Add-ons are the latest generation of add-ons, and provide many capabilities, including:

  • Build just one add-on for multiple Google Workspace apps: Instead of separate add-ons for Gmail, Calendar, Drive, and the Editors, you can build and manage a single Google Workspace Add-on to extend multiple Google Workspace apps.

  • Increase your brand awareness: Add-on icons are default visible in the right side panel of the add-on’s host apps.

  • Build homepage experiences: You can create individual homepages for each Google Workspace app your add-on extends, or use the same homepage for multiple apps.

  • Reflect the user's context in your add-on: You can design your Google Workspace Add-on to show interfaces specific the add-on’s host app. For example, your add-on can display info from an email or calendar event in your add-on, or suggest an action based on the current Google Workspace app page.

  • Use standardized interfaces: Construct user interfaces from built-in widget elements provided by the Apps Script Card service. You don't need any expertise with HTML or CSS to define these interfaces.

  • Extend desktop and mobile clients for Gmail: If a Google Workspace Add-on extends Gmail, you can use it in both the desktop and mobile versions of Gmail. If you build a Google Workspace Add-on that extends Gmail, you don't need to design a separate mobile version of the add-on. The same interface is used everywhere.

Editor Add-ons

Editor Add-ons extend one of the Google Editor applications, such as Docs, Sheets, Slides, or Forms. Each Editor Add-on type (for example, Sheets add-ons) can have its own set of type-specific capabilities, restrictions, and special considerations. When building Editor Add-ons, it's important to understand these Editor-specific details. For more details on add-ons for specific Editors, see the corresponding sections:

Editor Add-ons can automate common editor tasks such as file creation, editing, formatting, and moving data between applications. Editor Add-on interfaces are highly-customizable for the tasks at hand.

Editor Add-ons behave differently from Google Workspace Add-ons in the following ways:

  • Editor Add-ons can create interfaces consisting of menu items, dialogs, and sidebars. Add-on dialogs and sidebars are defined using standard HTML and CSS.
  • Editor Add-ons have special authorization rules because they create, modify, or otherwise interact with files within Google Drive. It is important to understand the Editor Add-on authorization lifecycle while developing an Editor Add-on.
  • Files created and updated in each editor have specific structures. For example, Google Slides presentations are composed of pages which can be slides, masters, or layouts. You should understand these file structures, as add-ons often interact with them when reading or editing files.
  • Editor Add-ons only function in desktop clients, not Android or iOS.