This page describes how to update or unpublish your app's listing in Google Workspace Marketplace. Make sure you're using the Google Cloud project for your app. ## Update your app listing To update the configuration or details of your app listing, follow these steps: 1. In the Google Cloud console, go to Menu \> **APIs \& Services** \> **Google Workspace Marketplace SDK** \> **App Configuration**. [Go to App Configuration](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) 2. On the **App Configuration** tab, update your configuration details, and then click **Save**. 3. On the **Store Listing** tab, make your changes, and then click **Publish**. ### Add OAuth scopes If you add OAuth scopes, you might need to file a new request for OAuth verification. If you update your listing to use the new scopes before they're approved, users are shown the unverified app screen. Quota limits are applied until the new OAuth verification request is approved. To learn more, see [Unverified apps](https://support.google.com/cloud/answer/7454865). ### Move your listing to a different organization If you move the Google Cloud project of a private, published app from its original organization to a different organization, the app remains associated with and accessible by the original organization. To give the new organization access to the app, you need to replicate the app and its listing in a new Google Cloud project using an account that belongs to the new organization. ### Change ownership of your listing To change the ownership of your listing, you must modify the owners of your listing's Google Cloud project. If you're a Cloud project owner, you can add or change owners for your Google Cloud project directly. For steps about modifying owners of a Cloud project, visit [Manage access to projects, folders, and organizations](https://cloud.google.com/iam/docs/granting-changing-revoking-access#using_the_console_name_short). If you're not a Cloud project owner or cannot modify access to the Cloud project, contact an administrator for your organization to request that they modify or transfer ownership. [Learn how to find your administrator](https://support.google.com/a/answer/6208960). > [!WARNING] > **Always share ownership of the Google Cloud project > for your listing.** If a sole Cloud project owner leaves your organization and their account is removed, you lose access to the Cloud project and your listing. If you've lost access to your listing, [file a support > case](https://cloud.google.com/support-hub/). ## Update your app listing with drafts You can make changes to your app listing and save them as a draft. This lets you preview and test the changes before publishing them. While your changes are under review, the original app listing remains available on the Google Workspace Marketplace. To update the configuration or details of your app listing, follow these steps: 1. In the Google Cloud console, go to Menu \> **APIs \& Services** \> **Google Workspace Marketplace SDK** \> **App Configuration**. [Go to App Configuration](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk) 2. Update your configuration details, and then click **Save Draft**. This creates a draft visible only to you. If the app was previously published, a dialog appears stating the draft was saved along with a link to the **Store Listing** tab. 3. On the **Store Listing** tab, make your changes, and then click **Save Draft**. The **Store Listing** tab displays the message **You're viewing a draft**. 4. To preview and test your draft app listing, you must add your email address to the **Draft Tester Email Addresses** field in the **Draft Tester** section on the **Store Listing** tab. You can also add other draft testers. For more information, see [Test your draft](https://developers.google.com/workspace/marketplace/manage-app-listing#test-draft). 5. To publish your draft, click **Publish**. 1. If **Submit for review** is displayed, your changes require a review before publishing. For more information, see [Actions that trigger a review](https://developers.google.com/workspace/marketplace/manage-app-listing#trigger-review). 2. To begin the review process, click **Submit for review** . After you submit changes for review, you can't edit your app listing until the review is complete but you can [cancel the review](https://developers.google.com/workspace/marketplace/manage-app-listing#cancel-review) of your app listing. If the review succeeds, your live app listing is automatically updated with the draft changes. If the review fails: - Your existing app listing isn't updated and the **Store Listing** tab displays the message **The draft didn't pass review and wasn't published**. - Your existing app listing remains unchanged. - You receive an email message describing what needs improvement. - You can edit your draft app listing to address the issues and resubmit your changes for review. - Alternatively, you can use the **More Actions** menu and click **Discard draft** to delete the draft. ### Actions that trigger a review If you update certain fields or make additions to your existing public app listing, your changes require a manual review before publishing. Reviews are required when you do the following: - Add a new extension type by checking additional boxes in the **App Integrations** section on the **App Configuration** tab. For more information, see [Identify how your app integrates with Google Workspace applications](https://developers.google.com/workspace/marketplace/enable-configure-sdk#choose-ws-apps). - Add new host products to a Google Workspace add-on. For more information, see [Create and manage deployments](https://developers.google.com/apps-script/concepts/deployments#add-hosts) and [Build a Google Workspace add-on using HTTP endpoints](https://developers.google.com/workspace/add-ons/guides/alternate-runtimes#add-hosts). - Modify any field in the **App Details** section on the **Store Listing** tab. This includes the **Language** , **Application name** , **Short description** , or **Detailed description** fields. For more information, see [Create a store listing](https://developers.google.com/workspace/marketplace/create-listing). ### Cancel a review You can cancel an app listing that's been submitted for review. If you cancel the review, your app returns to its draft state. The original app listing remains available on the Google Workspace Marketplace. To cancel the review of your app listing, follow these steps: 1. In the Google Cloud console, go to Menu \> **APIs \& Services** \> **Google Workspace Marketplace SDK** \> **Store Listing**. [Go to Store Listing](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) 2. Click **Cancel Review**. Submitting your app listing for review after canceling might result in an error. To resolve this error, wait before attempting to submit your request again. ### Status messages As you create, edit, and publish app listings, the Google Workspace Marketplace presents messages on the **Store Listing** tab that vary depending on the state of your app listing and whether you have a draft. The following table describes the most common status messages: | Status message || |---|---| | **You're viewing a draft** | You saved changes to the **App Configuration** or **Store Listing** tabs. If you're updating a published app listing, the app no longer matches the published app listing. To reset the settings so that they match the published app listing, use the **More Actions** menu and click **Discard draft** to delete the draft. | | **You're viewing a draft. Changes made in this draft require a review before publishing.** | You saved changes to a field in the **App Details** section on the **Store Listing** tab. If you're updating a published app listing, the configuration settings no longer match the published app listing. To reset the settings so that they match the published app listing, use the **More Actions** menu and click **Discard draft** to delete the draft. | | **The draft is in review and can't be edited.** | You submitted your public app listing for review. Apps must pass a review before being published. While an app is in review, you can't edit it. You can remove the app from the review process by clicking **Cancel Review**. If the app is approved, it will be published automatically. | | **The draft didn't pass review and wasn't published** | Your app requires additional work. You'll receive a review document that describes what needs improvement. You can address the issues and resubmit your app for review. [Learn about the review process](https://developers.google.com/workspace/marketplace/about-app-review#duration). Alternatively, you can use the **More Actions** menu and click **Discard draft** to delete the draft. | | **This app is published** | You have an app listing that appears in the Google Workspace Marketplace. | | **The app was unpublished from Google Workspace Marketplace.** | This message appears only when Google unpublishes your app listing. It doesn't appear when you unpublish your own app listing. [Learn more about the Google Workspace Marketplace policies](https://developers.google.com/workspace/marketplace/terms/policies). | ### Test your draft You can test your draft app listing by adding draft testers. After you designate a specific email address as a draft tester, the person who signs in to the Google Workspace Marketplace with that email address sees the draft version of your app listing instead of any existing app listing. If you have a draft that can be previewed and tested, the **Draft Tester** section appears in the **Store Listing** tab. > [!NOTE] > **Note:** The following app integrations can't be previewed and tested: Web Apps, Drive Apps, and Chat Apps. If a draft contains changes that involve only those app integrations, the **Draft Tester** section doesn't appear. To test your draft, follow these steps: 1. In the Google Cloud console, go to Menu \> **APIs \& Services** \> **Google Workspace Marketplace SDK** \> **Store Listing**. [Go to Store Listing](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) 2. On the **Store Listing** tab, add your email address to the **Draft Tester Email Addresses** field in the **Draft Tester** section. 3. If you want to let others test your draft, add their email addresses to the **Draft Tester Email Addresses** field and notify them that they are draft testers. - You can add up to 100 email addresses. - For public app listings, the email addresses must be Gmail accounts. - For private app listings, all email addresses, including yours, must be in the same domain. - Draft testers are not automatically notified when you add their email address to the **Draft Tester Email Addresses** field. 4. Add a URL to the **Draft Tester Opt-Out URL** field. - The URL must provide a mechanism, such as a web form, that lets testers indicate that they don't want to be draft testers. - You must maintain the list of draft testers and remove those who have opted out. ## Unpublish your app listing To unpublish your app listing, follow these steps: 1. In the Google Cloud console, go to Menu \> **APIs \& Services** \> **Google Workspace Marketplace SDK** \> **Store Listing**. [Go to Store Listing](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com/googleapps_sdk_publish) 2. On the **Store Listing** tab, click **Unpublish** . To republish, follow the preceding steps and click **Publish**. After you unpublish, your app listing no longer appears in the Google Workspace Marketplace. New users cannot find or install the app. Users who have already installed your app can no longer access it. If you republish, the users who had previously installed your app regain access. While unpublishing is intended to prevent access for all users, it doesn't consistently remove the app from the accounts of existing users who already have it installed. To fully deprecate an app so that no users (new or existing) can access it, you must delete the associated Cloud project. For more information, see [Delete and restore projects](https://docs.cloud.google.com/resource-manager/docs/delete-restore-projects).