Extending G Suite with Add-ons

Add-ons run inside Google Sheets, Docs, Slides, Forms, and Gmail, but they're built by developers like you. Our new platform lets you add menu items and sidebars, edit files programmatically, and tie into over a dozen Google services without even spinning up a server. This guide shows you everything you need to publish your first add-on, so that millions can discover it in our store.

Add-ons that extend Google Sheets, Docs, Slides or Forms are called editor add-ons, since they operate within one of the Google Drive editor applications.

See what you can make

Add-ons are built with Apps Script, a server-side JavaScript platform that requires zero setup.

Understand the development cycle

You build your editor add-on in a standalone Apps Script project. Make sure you understand the intricacies of the Add-on authorization lifecycle. Your add-on should adhere to the UI style guide.

When you have a working version, you should test the add-on to ensure it behaves as expected. Once your editor add-on is complete, publish to the store. After that, G Suite users worldwide—or, if you prefer, just users within your domain—are able to use your add-on when working in G Suite applications.

Brand it as your own

Your add-on can present your brand to your users, but you should adhere to the Add-on UI guidelines for branding. Here is some additional information on how you can present your add-on.

Present a consistent user experience

For the best user experience, make sure your interfaces adhere to the Add-on UI guidelines. When you're using the HTML service to build your add-on interface, use our CSS package to make your add-on styling consistent with the G Suite editors.

Serve images

Most add-ons include a logo or other images. These assets aren't packaged with the add-on; instead, your user interfaces reference them just like any other web page would. You can host assets on your own web server, or host them using a solution like Firebase Hosting.

Join the Add-ons menu

Each editor add-on gets a spot in the Add-ons menu for its editor. The add-on's menu includes an automatic Help item that lets users send feedback to the developer. You can customize the content of your add-on menu, and even create dynamic menus that change based on add-on state.

Connect to Google services

Apps Script includes special services to let you programmatically interact with G Suite data. You can create, read, and edit G Suite application files, access Gmail and Calendar, search Drive, and more. To build most add-ons, you'll need to be familiar with at least one of these services.

Illustration of Google Sheets editor

Spreadsheet service

The Spreadsheet service treats Google Sheets as a grid, operating with two-dimensional arrays.

Illustration of Google Docs editor

Document service

The Document service interface for Google Docs is similar to the XML document-object model.

Illustration of Google Forms editor

Forms service

The Forms service constructs a Google Form as a list of question items and layout items.

Slides service

The Slides service lets you fetch and manipulate presentations and their contents.

Publish your add-on

Once your add-on is a working prototype, publish to the store. Note that public add-ons undergo a review process to ensure they meet our content and style guidelines. See you in the store!