The information you provide on the Store Listing page advertises your app to potential users within the [Google Workspace Marketplace](https://workspace.google.com/marketplace/). Some of the fields are optional, but filling them out can help make your app listing more descriptive. Regardless of whether you publish your app publicly or privately, you must complete a store listing. For more information, see [Determine the audience for your app](https://developers.google.com/workspace/marketplace/how-to-publish#audience). [Video](https://www.youtube.com/watch?v=Xs09ysP-ppI) ## Gather your assets We recommend that you collect the following assets before you fill out the Store Listing page. ### App details App details are displayed on your Store Listing page in the Marketplace. #### Required fields | Field | Description | |---|---| | **Language** | The language(s) for your app details. If you include multiple languages, users who have selected a specific language view the localized version. Otherwise, users view your app details in the default language that you choose. | | **Application name** | This is the name shown in the app listing and should match the name in your OAuth consent screen. Limit the name to 50 characters or less to ensure it displays well. Don't use the word "Google" or other Google product names. | | **Short description** | A short summary of your app and what it does (200 character limit). | | **Detailed description** | A longer description of your app. It's presented in the Overview section, under the screenshots you provide. Limit this to less than 16,000 characters. | | **Category** | Select the category most appropriate for your app listing. When you publish, your app listing appears in that collection for greater discoverability. | #### Optional fields We recommend that you include pricing information for your app. In the **Pricing** field, you can specify the pricing model for your app: - **Free of charge**: Users can install and use all of the app's features free of charge. - **Free of charge trial**: Users can use the app free of charge for a period of time. - **Free of charge with paid features**: Users can access the app free of charge but must pay for select features, such as premium features. - **Paid**: Users must pay to access and use the app. ### Graphic assets Graphics are used in the Marketplace to illustrate and advertise apps. #### Required fields | Field | Description | |---|---| | **Application icons** | Appears as the large icon on the app's details page, as well as in other locations. Requires at least two sizes: 32x32 and 128x128 pixels. If your project includes a web app, you also need 48x48 and 96x96 pixels. | | **Application card banner** | Appears as the graphic for your app on both the app listings page and the search results page of the Marketplace. Required size: 220x140 pixels. | | **Screenshots** | Appears on the Overview tab of the app's details page with multiple images appearing within a carousel widget. Requires at least one screenshot showing your app's integration with Google services, but you can provide up to 10. The recommended size is 1280x800 pixels, though 640x400 or 2560x1600 pixels are also accepted. Screenshots should have square corners and no padding (full bleed). | #### Optional fields Optionally, in the **YouTube Promo Videos** section, you can add one or more YouTube videos that describe and promote your app. ### Support links Support links let users get help with your app and review your terms and policies. #### Required fields | Field | Description | |---|---| | **Terms of service** | A link to a web page that describes your terms of service. | | **Privacy policy** | A link to a web page that describes your privacy policy. | | **Support** | A link to a web page that describes how your users can get help from you if they're having issues with your app. | #### Optional fields | Field | Description | |---|---| | **Setup** | A link to a web page that describes how to set up the app after installation. Recommended if the app requires configuration that's hard to explain well within the UI. | | **Admin config** | A link to a web page that tells domain administrators how to configure the app for their users. Unnecessary unless the app requires a domain-level configuration. | | **Help** | For use with Editor add-ons only. If this link is provided in the add-on's **Help** menu, a **Learn more** button is presented. | | **Report issue** | For use with Editor add-ons only. If this link is provided in the add-on's **Help** menu, a **Report an issue** button is presented. | ## Publish an app > [!NOTE] > **Note:** Before you publish, test your app. Once you save your visibility option, you can't change it. 1. In the Google Cloud console, click **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. Fill out the sections for **App Details** , **Graphic Assets** , **Screenshots** , and **Support Links** . If you use or mention any [Google trademarks](https://about.google/brand-resource-center/), ensure that your app complies with the [Google Workspace Marketplace branding guidelines](https://developers.google.com/workspace/marketplace/terms/branding). 3. (Optional) To publish your app to only select regions, in the **Distribution** section, clear **All Regions** and select the regions where you want the listing to be visible. For users whose IP address isn't in a selected region, the following occurs: - When they search for apps in the Marketplace, your app listing isn't returned. - When they try to access the listing with a direct link, they get an error. For each region, ensure that you've included the region's language in the **App Details** section. 4. To save the information and publish, click **Submit For Review**. 1. If your app listing is marked as private, it's published right away. 2. If your app listing is marked as public, it goes through a review process before it's published. For more information, see [App review process and requirements for the Google Workspace Marketplace](https://developers.google.com/workspace/marketplace/about-app-review). ## Share your app listing To give someone access to your app listing, add them to your Google Cloud project. For more information, see [Grant a single IAM role](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access#grant-single-role). If you built your app with Apps Script, you can use a shared drive as the source location for your script project. This makes sure that no single account is the sole owner of the project. Make sure your collaborators have access to the shared drive. Once your app listing is published, install the app on a test domain and make sure it works as intended. ## Check your app listing's publication status For public app listings, you receive emails about its publication status during the review process. The emails are sent to the [developer email address](https://developers.google.com/workspace/marketplace/enable-configure-sdk#developer-information) that you provided for your app listing. You can also check whether your app listing is live by following these steps: 1. In the Google Cloud console, click **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. At the top of the page, find your publication status. 3. If your listing includes a Google Chat app, go to the Google Chat API **Configuration** page. [Go to Chat API Configuration page](https://console.cloud.google.com/apis/api/chat.googleapis.com/hangouts-chat) - Make sure that your **App status** is set to **Live** . If it's set to **Disabled**, your app listing remains unpublished regardless of the status in the Google Workspace Marketplace SDK. - For more information about these settings, see [Configure the Google Chat API](https://developers.google.com/workspace/chat/configure-chat-api). For a list of possible publication statuses and their definitions, see [Status messages](https://developers.google.com/workspace/marketplace/manage-app-listing#status-messages).