Publishing Your App

Once you have set up your project, built your app, and tested that it works, you can publish it on the G Suite Marketplace. This section explains the steps to publish your app.

Before You Publish

Here are a few things to consider as you prepare to publish:

  • If you have never published an app on G Suite Marketplace or the Chrome Web Store, you will need to register and pay a one-time fee using Google Wallet. Go to Chrome Web Store Developer Dashboard to register.

  • Note that G Suite Marketplace and Chrome Web Store use the same Chrome Web Store Developer Dashboard to manage listings. However, you must include separate listing for each the Chrome Web Store and G Suite Marketplace if you list in both. Once you publish each listing, they will undergo separate review processes. Once live, these two listings are not linked. See Publishing Your App in the Chrome Web Store documentation for details.

  • While it isn't a requirement, it's very helpful to have your own Google enterprise domain "sandbox" where you can install and test your app after you publish it on the G Suite Marketplace.

Resources you'll need

We recommend that you prepare resources like icons, screenshots, and information about the app to streamline the listing process. When you publish your app, keep in mind that you'll need the following resources:

  1. A manifest file specific to your G Suite Marketplace listing in a zip file
  2. Icons to be included in the zip file that you upload with the manifest zip file
  3. Screenshots of your app: you must provide at least one, and can provide up to four
  4. URL used to launch your application

Here are more details on these resources:

Manifest file

One item in the zip file you'll upload is the manifest file. This JSON file, which must be named manifest.json, contains the following collection of name/value pairs:

{
  "manifest_version": 2,
  "name": "Welcome Aboard",
  "version": "0.0.0.1",
  "description": "a plain text description",
  "icons": {
    "128": "icons/128x128-icon.png",
    "16": "icons/16x16-icon.png"
  },
  "container": ["DOMAIN_INSTALLABLE"],
  "api_console_project_id": "428464274542",
  "app" : {
    "launch" : {
      "web_url" : "http://www.example.com/morepath/"
    }
  }
}

The api_console_project_id is your app's project number (shown as App ID in the G Suite Marketplace SDK configuration from the Set Up Your Project step.)

The value for container is an array containing one or more of the following strings:

  • DOMAIN_INSTALLABLE: all Marketplace apps include this container
  • GOOGLE_DRIVE: include this container if your app is a Google Drive app

The web_url string in the app section of the manifest defines the actual URL used to launch your app.

Icons

You need to provide two icons in the zip file; the path to these icons specified in the manifest file is the path relative to manifest.json itself.

Screenshots

You must provide at least one screenshot of your application and you can provide up to a maximum of five screenshots. If your app supports multiple locales, you can provide locale-specific screenshots. Your screenshot should have square corners and no padding (full bleed).

We suggest that screenshots be 1280x800 pixels in size, as they will be used in future high dpi displays. Currently, the Chrome Web Store will downscale all screenshots to 640x400, so if your screenshots will not look good downscaled or if 1280x800 is too big for your app, we also support 640x400 pixels screenshots.

You may also include a YouTube video demonstrating the UI of your application if desired, but this is not required.

URLs

It is required to have the the verified URL that will launch your application. You may optionally have handy a link to your main website, as well as to support & FAQs if applicable.

Steps to publish the app

Once everything is prepared, follow these steps to add your G Suite Marketplace listing.

  1. Go to the Chrome Web Store developer dashboard
  2. Upload the zip file that contains the manifest.json file and icons
  3. Add a detailed description of your app for the Marketplace listing
  4. Add your screenshot(s) and promotional tiles for the Marketplace listing
  5. Add the URLs for your app's websites
  6. Set the category, region, language(s), and other configuration details

Note: To publish a private, domain-only app, skip the next step and see the instructions below.

From here, preview your changes to make sure the listing looks OK. Click Publish changes when you're done.

Once you publish, our review team will investigate your application to ensure that it meets our requirements. Note that it can take up to a week to verify that your app meets technical requirements before it appears on the G Suite Marketplace.

After your application is approved, it will appear on the Marketplace. We suggest installing it on a test domain. If everything is working correctly, you're done!

Domain-only private apps

To publish a Marketplace app that is only visible within your own domain, do not use the listing review request form. Instead, on the developer dashboard, locate the "Visibility options" section and select "Private / Everyone at yourdomainname.com" before you publish, as shown here:

Once published, your app will then appear in the "For yourdomain.com" section in the G Suite Marketplace available on admin.google.com.

To monitor install metrics for your app, go to Google Developer Console and select your project. Then go to APIs, navigate to G Suite Marketplace SDK, and click the Usage tab.

Send feedback about...

G Suite Marketplace
G Suite Marketplace