Web apps built with Apps Script can be distributed in the G Suite Marketplace, where G Suite domain administrators can find, install and authorize them for all or some users in their domains.
This section lists a number of considerations and details that you should address when you distribute a web app.
Team ownership of the web app
If you are building the web app as part of a team, think carefully about which account you want to publish from. Collaborating with shared drives is recommended. Alternatively, you may wish to create a common team account to serve as the owner of the script project. Avoid situations where you lose access to your add-on's code and console settings because a member of your team left your organization.
Changing web app ownership across domains
Web apps deployed in one domain cease to function if their ownership changes to a shared drive or account in a different domain. This can be corrected by having the new owner or collaborator redeploy the web app in the new domain. Alternatively, the web app can start functioning again without redeploying if you move it back to its original domain.
Steps to prepare for distribution
Prior to distributing, you should:
- Ensure your web app is in good working order and is complete — works in progress should not be published.
- Your web app script project must be using a standard Cloud Platform (GCP) project. If it is using a default GCP project, you must switch it to use a standard one. You must also have access to the standard GCP project in order to configure it.
- Make sure the web app meets the requirements for web apps.
- Collect or create the text and graphical assets
needed for the G Suite Marketplace listing of your web app. In addition,
make sure you have the following graphic assets:
- One or more 1280x800 or 640x400-pixel screenshots
- a 440x280-pixel promotional tile image. You can optionally also include a larger 920x680-pixel tile and a 1400x560-pixel marquee image.
- a 128x128-pixel app icon
- a 32x32-pixel app icon
- a 48x48-pixel app icon
- a 96x96-pixel app icon Follow the Chrome Web Store image guidelines when creating these images. If you provide an icon of a different size it is resized for you, but the other images must be exactly sized.
- Make sure to have a URL pointing to a terms of service page for your web app; this is presented with your web app entry in the G Suite Marketplace.
Domain-wide distribution instructions
Domain-wide distribution requires configuring the G Suite Marketplace SDK for your web app. In order to do this, you must have access to the Cloud Platform (GCP) project the add-on uses. This project must be a standard GCP project, not the default project created for a new script.
Once you've prepared all the required assets, you can Publish your web app to the G Suite Marketplace.
Migrating from the Chrome Web Store
In order to improve the discovery experience for users and admins, we are phasing out publication of web apps to the Chrome Web Store as part of domain-wide distribution. Because of this change, you may need to take some additional steps to migrate existing web apps that were published to both locations.
If you have a web app that was previously published to the Chrome Web Store and G Suite Marketplace, do the following:
- Verify that you have enabled the G Suite Marketplace SDK for your app.
- Complete the Configuration panel of the G Suite Marketplace SDK, updating and adding any required information.
- Complete the Publish panel of the SDK.
- Click Publish changes when you're done.
Install a published web app for a domain
To install the published web app on for all users in a G Suite domain, see this support article. Only an administrator can install an app for all users in the domain.