Publishing add-ons

When you publish your add-on, you are making it available to for others to find, install, and use.

Before attempting to publish an add-on, familarize yourself with the the following publishing terms. When you are ready, see Publish Gmail add-ons or Publish editor add-ons for full publication instructions.

Publication terminology

The following terms are used frequently when discussing add-on publication.

Asset

A text, image, video, or URL component of an add-ons listing. During the publication process you must create or provide a number of assets. Some assets are required and others are optional.

See Assets needed for Marketplace listings for descriptions of assets you can provide.

Add-on review

The process wherein add-ons submitted for public publication are examined by Google to ensure they meet all requirements and guidelines for public add-ons.

See Add-on review for more details.

Chrome Web Store migration

Originally, add-ons were published to the Chrome Web Store, and could optionally be published in the G Suite Marketplace to make them domain-wide installable. As of August 2019, all add-ons are published to the G Suite Marketplace. For more details, see Chrome Web Store migration.

Individual installs

Domain administrators can find and install any add-on published in the G Suite Marketplace for all or some users in their domain. If a domain user instead installs the add-on for themselves directly, it is known as an individual install.

While configuring your add-on for publication to the G Suite Marketplace, you can elect to allow or prevent individual installs; individual installs are enabled by default. Note that a user's domain policies may prevent them from installing an add-on even if individual installs are enabled.

Listing

The entry describing your add-on in the G Suite Marketplace once it's published. Listings consist of a combination of text, images, video, and URL assets that you must create or provide during the publication process. The add-on listing functions as an advertisement for your add-on, and so should be designed and built carefully.

Published

An add-on publication state. Published add-ons have successfully completed the publication process and appear in the G Suite Marketplace.

Unpublished

An add-on publication state. Unpublished add-ons have not completed the publication process and are not listed in the G Suite Marketplace. This doesn't mean the add-on is incomplete—it's possible to create and use an add-on without publishing it. You can even share unpublished add-ons for others to install and use.

Visibility

Whether a published add-on is available to everyone (public) or only users in the same domain as the publishing account (private). Only published add-ons have a meaningful visibility status.

Private

Private add-ons are only visible to users in the same domain as the add-on publishing account. They can't be installed by outside users. Private add-ons do not require add-on review. Private visibility is sometimes referred to as My Domain visibility.

Public

Public add-ons are visible globally in the G Suite Marketplace. Anyone can see and install them if their domain policies allow it. Public add-ons must go through the add-on review process before they are published. This review process can take several days to complete, and may require you to make changes to your add-on code.