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 must 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 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 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 require 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 five
  4. The URL used to launch your application

The following sections describe those resources.

Manifest file

You must include a manifest file in the zip file you upload. This JSON file, which must be named manifest.json, containing 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).

Screenshots should be 1280x800 pixels in size. If necessary, screenshots 640x400 pixels in size can be used.

You may also optionally include a YouTube video demonstrating the UI of your application.

URLs

It is required to have the verified URL that launches your application. You may optionally include a links to your main website, and any support or FAQs pages.

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 submit your app for publication, our review team investigates 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 appears 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 then appears 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
Need help? Visit our support page.