Hide

Distribute a Web App through the Chrome Web Store

After you deploy a web app, other users can run the app if they have the link to it and have been given permission, but links alone can be hard to share. To make your web app easier to discover, you may want to distribute it publicly in the Chrome Web Store, where it can be found and installed by millions of users.

You may also want to distribute your web app in the Google Apps Marketplace, where Google Apps domain administrators can find and install it for all or some users in their domains.

Checklist

Prior to distributing, you should:

Distributing to the Chrome Web Store instructions

To distribute a web app to the Chrome Web Store, follow the steps below:

  1. Open your web app script in the Apps Script editor.
  2. Follow the steps to deploy your web app script. You may have already done this while testing the web app. When deploying, make sure you indicate the correct project version. In the Deploy as web app dialog, select User accessing the web app in the Execute the app as box. Select Anyone in the Who has access to the app box.
  3. In the script editor, click Publish > Register in the Chrome Web Store. Click the Register Web App button.
  4. If you have not yet agreed to the Chrome Web Store terms of service, a dialog will appear prompting you to do so. Click the Terms of Service link, to open a new window, read through the terms and click Accept. Close the window. Back in the script editor, click OK, then click Publish > Register in the Chrome Web Store again, then click the Register Web App button.
  5. In the Chrome Web Store dialog that appears, click the Chrome Web Store's Developer Dashboard link.
  6. Fill in the Edit Item form on the Chrome Web Store page.
    • Do not upload a file in the Upload section at the top of the page; Apps Script generates this file automatically for you and uploading a separate file will cause the publication to fail.
    • Enter a description of your web app in the Detailed Description field.
    • Upload the icon, a screenshot, and tile image you created for the web app.
    • Select a Category and Language.
    • Under Visibility options, select Public if you want to distribute to the public store, Unlisted if you want the web app to be available to only those with the Chrome Web Store entry link, or Private if you intend to distribute only for users within your private Google Apps domain.
  7. Click Publish changes, then click OK in the dialog that appears.
  8. If you have never published an app to the Chrome Web Store before, you may be required to register and pay a small, one-time fee before publication can proceed. In this event, follow the instructions presented to pay this fee using Google Wallet.
  9. Visit the Chrome Web Store developer dashboard to see the distribution status of your web app. Note that the publication process can take up to an hour to finish. Once the "Status" column says "Published", your web app will be available in the store.

If you are distributing your web app publically, you're done! The web app can now be installed by users from the Chrome Web Store.

Install a distrubuted web app

Once you've distributed a web app in the Chrome Web Store, users will be able to discover it via searching the Chrome Web Store, browsing through categories, or by directly accessing the URL of the listing in the Chrome Web Store. You can learn more about installing free and paid web apps in the Chrome Web Store help center.

Update a distrubuted web app

Updating a web app's code

If you wish to make a code change to a web app you have already distrubuted, follow these steps:

  1. Open the web app script in the script editor.
  2. Make the changes you wanted. Test the code to ensure it functions as intended and is bug-free.
  3. Click File > Manage Versions. Enter a new version description and click Save New Version. Click OK to close the dialog.
  4. Click Publish > Deploy as web app. Update the Project version to the new version you just created.
  5. Click Update.

Updating a web app's Chrome Web Store listing

If you want to update the Chrome Web Store listing for your web app, follow these steps:

  1. Open the web app script in the script editor.
  2. Click Publish > Register in Chrome Web Store. Click Edit store item. This will bring up the Edit Item form you filled out during publication.
  3. Make the changes you want to the description, graphic assets or other settings.
  4. Click Publish changes.
  5. Visit the Chrome Web Store developer dashboard to see the publication status of your web app. Note that the publication process can take up to an hour to finish. Once the "Status" column says "Published", your web app will be available in the store.

Updating a web app's icon on the New Tab Page

By default your app will appear with an Apps Script logo on Chrome's New Tab Page after it is installed. To use a custom icon you will need to temporarily host the icon image on a publicly accessible URL and then update the app using the steps below.

  1. Open the web app script in the script editor.
  2. Click Publish > Register in Chrome Web Store.
  3. Click the link titled specify an alternative image.
  4. Enter the URL of your icon image and click the OK button.

Remove your web app from the Chrome Web Store

To remove the web app listing from the Chrome Web Store, do the following:

  1. Open the Chrome Web Store Developer Dashboard.
  2. Find the entry for the web app. On the right side of the entry, click Unpublish. This will remove the listing from the Chrome Web Store.
  3. If you also wish to delete the dashboard entry, click Delete.

These steps will remove the publication, but the web app will still function. To disable the web app:

  1. Open the web app script in the script editor.
  2. Click Publish > Deploy as web app.
  3. Click the Disable web app link.
  4. Click Yes in the dialog that appears. Note that you can re-enable the web app later by reopening the Deploy as web app dialog.

Send feedback about...

Apps Script