The information you provide on the Store Listing page advertises your app to potential users within the Google Workspace Marketplace or bot catalog. Some of the fields are optional, but filling them out can help make your app listing more descriptive.
Gather your assets
We recommend that you collect the below assets before you fill out the Store Listing page.
The following information is required:
|Language||If your app supports multiple locales, you should create localized versions of your app’s name and descriptions (short and detailed).|
|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 characters 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.|
Optionally, you can add pricing information by selecting the pricing model most appropriate for your app listing.
Graphics are used in the Google Workspace Marketplace and the bot catalog to illustrate and advertise apps.
The following graphic assets are required:
|Application icons||At least two icon images—one sized to 128 x 128 pixels and another to 32 x 32 pixels. Apps that include a web app also require 96 x 96 and 48 x 48 pixel icons.|
|Application card banner||Sized to 220 x 140 pixels.|
|Screenshots||At least one screenshot showing your app’s integration with Google services is required, but you can provide up to five. These should be 1280 x 800 pixels in size. If necessary, screenshots 640 x 400 pixels or 2560 x 1600 pixels in size can be used. Your screenshots should have square corners and no padding (full bleed).|
Optionally, you can add links to promotional YouTube videos that further describe your app and show it in action.
Add links that let users learn more about your app. The following URLs are required:
|Terms of service||A link to a web page that describes your terms of service.|
|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.|
You can further enhance your app by providing the following URLs:
|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.|
|Deletion policy||A link to a web page that describes how and when your app deletes user data. Strongly recommended if you collect and store user data.|
|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
- In the Google Workspace Marketplace SDK, at the left, click Store Listing.
- Fill out each section.
- To save the information and publish, click Publish.
- If your app listing is marked as private, it’s published right away.
- If your app listing is marked as public, it goes through a review process before it’s published. See About app review.
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
You can check whether your app listing is live by following the steps below:
- Open your app’s Cloud Platform project in the Google Cloud Platform console.
- At the top left, click Menu > APIs & Services.
- In the list at the bottom, click Google Workspace Marketplace SDK.
- At the left, click Store Listing.
- At the top of the page, find your publication status.
Here are the possible publication statuses and their definitions:
|Unpublished||Your app listing is not live. This status appears
|Under review||Your app listing is not live.
Your app is under app review with the Google team. You’ll receive an email notification when app review is complete. To learn more, see About app review.
|Approved||Your app listing is live. Unless you’ve published
as unlisted, new users can find and install your app on the
Google Workspace Marketplace or the Google Chat chatbot catalog.*
If you published your app listing as unlisted, new users need the direct URL to access it.
Some domain administrators might have applied restrictions that limit users’ access to your app.