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
- Review Apps Script If you're unfamiliar with Apps Script, start with the brief overview of Apps Script. When you are finished with that, you can find more details in the Apps Script documentation.
- Try a quickstart! In just a few minutes, you can:
- Wondering what other developers have built? Just click to open the store for Sheets, Docs, Forms, or Slides.
Understand the development cycle
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.
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.
The Spreadsheet service treats Google Sheets as a grid, operating with two-dimensional arrays.
The Document service interface for Google Docs is similar to the XML document-object model.
The Forms service constructs a Google Form as a list of question items and layout items.
The Slides service lets you fetch and manipulate presentations and their contents.