List app integrations together

If you’ve developed multiple app integrations, you might want to publish them together in one app listing. Doing so lets users install and authorize them at the same time, provides a more seamless user experience, and consolidates your app's user count.

For example, if your app offers a specific integration with Sheets and is available as a web app, instead of creating two app listings for a Sheets add-on and a Web app, you can list them together as one app.

To determine if you can list your app integrations together, refer to the next section.

App integrations you can list together

Use the table below to learn which app integrations can be included in a single app listing.

Can be included with: Web app Drive app Docs add-on Sheets add-on Slides add-on Forms add-on Google Workspace Add-on (Gmail, Calendar, and Drive add-ons)* Google Chat bot**
Web app x x x x x
Drive app x x x x x x
Docs add-on x x x x x
Sheets add-on x x x x x
Slides add-on x x x x x
Forms add-on x x x x x
Google Workspace Add-on (Gmail, Calendar, and Drive add-ons)* x x
Google Chat bot**
*Google Workspace Add-ons: You can’t list more than one Google Workspace Add-on, but you can build a single Google Workspace Add-on that extends Gmail, Calendar, and Drive.

**Google Chat bots can’t be included with other app integrations.

Before you add multiple app integrations

Before you include more than one app integration in your app listing, consider the following effects:

  • The consent screen lists all scopes required by all app integrations.
  • If you add a new app integration that requires additional scopes to an existing app listing, administrators who have already installed the original app for their domain need to authorize the additional scopes. Until they do, users within the domain are individually prompted to authorize.

If you plan to combine existing app listings, there are additional effects to consider. If you move an app integration from its original app listing to another app listing:

  • Existing users might lose access and need to install the app listing you moved it to.
  • User counts and reviews don’t carry over.
  • You might need to update the consolidated Google Cloud Platform (GCP) project’s configuration to accommodate the new app integration.

Add multiple app integrations to a new app listing

  1. If you haven’t created a GCP project yet, see Set up a Google Cloud Platform project. If you built your app integrations in Apps Script, make sure they're all associated with the same GCP project.
  2. Enable and configure the Google Workspace Marketplace SDK with the information for all the app integrations. Explain in the description that the app includes multiple app integrations.

Add app integrations to an existing app listing

  1. Make sure you have edit access to the existing app’s GCP project.
  2. If the app integration you want to add was built with Apps Script, switch your add-on’s Apps Script project to use the existing app’s GCP project.
  3. In the existing app’s GCP project, update the Google Workspace Marketplace SDK.
    1. On the App Configuration page under App Extension, select the app integration to add and fill out the relevant fields.
    2. Add information about the new app integration to the App Configuration and Store Listing pages. Make sure you explain in the app description that the app includes multiple app integrations.