Publish in the Chrome Web Store

Published on Updated on

This page describes how you publish a new extension or theme ("item") to the Chrome Web Store.

To publish updates to an existing item, or to update the percent rollout, see Update your Chrome Web Store item. To learn about group publishers, see Set up group publishing.

Before you publish an extension, you need to load it locally and test that it works, as described in Development Basics. Make sure that it runs correctly and that all its functionality works as you intend.

To publish your item to the Chrome Web Store, follow these steps:

  1. Create your item's zip file.
  2. Create and setup a developer account.
  3. Upload your item.
  4. Add assets for your listing.
  5. Submit your item for publishing.

We'll go into detail about each step below.

Create your item's zip file

To upload your item, you need to create a ZIP file that contains the manifest file located in the root directory and the files for your extension. The manifest file must specify at least the following fields:

  • "name":—This name appears in the Chrome Web Store and in the Chrome browser
  • "version":—The version of the metadata, incremented
  • "icons":—An array specifying the icons your item uses
  • "description":—A string of no more than 132 characters describing your extension

Your zip file may also include other images and any files that the item requires. The contents of the ZIP file and manifest depend on the specifics of your item.

Tips:

  • Set the initial version number in the manifest to a low value, such as 0.0.0.1. That way, you have room to increase the version number when you upload new versions of your item. Each new version that you upload to the Chrome Web Store must have a larger version number than the previous version.

Create and setup a developer account

Before you can publish your item on the Chrome Web Store, you need to pick a developer account to own your items, then set up your account in the Chrome Web Store.

Create your account

First you will need to register as a Chrome Web Store developer. We suggest using a new account just for your item instead of your personal account.

If you already host your item in Google Play and you want your Chrome Web Store listing to show an "Available for Android" link, your item must have the same name as your Google Play listing, and both items must be owned by the same developer account. To transfer your Chrome Web Store item to a different developer, submit this form.

Set up your account

After registering, finish setting up your developer account on the Account page. (To access the Account page click the link in the left menu.

Chrome Web Store Account page

Here you can provide your developer profile information, configure management settings and enable email notifications, among other things. The page itself provides instruction; however, there a few fields worth calling out.

FieldDescription
Publisher name(Required) Appears under the title of each of your extensions. If you are a verified publisher, you can display an official publisher URL instead.
Add email(Required) Only displayed under your extensions' contact information. Any notifications will be sent to your Chrome Web Store developer account email.
Privacy policy(Required) A link to the privacy policy for all your extensions. The policy should include how data is collected, used, and disclosed. See the User Data FAQ for more details.
Physical address(Required) Only items that offer functionality to purchase items, additional features, or subscriptions must include a physical address.
Trusted tester accounts(Optional) A comma-separated list of individuals' email addresses to make your extension available to them for testing.
Important

The Trusted tester accounts field does not support using group email addresses such as those used for posting to Google groups or other forums. If you need to test with a group, do so using the item level visibility setting. Click Items in the menu at left. Scroll to Visibility. Then select Private and Only trusted testers from the current publisher settings.

Verify your email address

Verifying your contact email address is now mandatory when you set up a new developer account. When you click Add email on your account page, you can enter an email address and then request verification. The Chrome Web Store then sends a verification link to that address; use that link to verify your address.

If you have an existing account and you haven't verified your contact email address yet, your address appears as "unverified" in the developer dashboard, as shown in this screenshot:

Contact email field showing as unverified

Click the Verify email link to send the verification link to your email.

Upload your item

To upload your item, use the Chrome Developer Dashboard.

If you need the item ID to complete your item's code, then you need to upload the item while you're still writing its code. Otherwise, you can wait until the item is finished. You can upload your item many times before submitting it for review.

When your item, its Chrome Web Store listing, and all the sites it relies on are ready, you can publish your item.

You cannot have more than 20 extensions published on the Chrome Web Store. There is no such limit on the number of themes.

Here's how to upload your item:

  1. Go to the Chrome Developer Dashboard.
  2. Sign into the developer account you chose in Step 1.
  3. Click the Add new item button.
  4. Click Choose file > your zip file > Upload. If your item's manifest and ZIP file are valid, you can edit your item on the next page.

Submit your item for publishing

Once you've uploaded your extension, you will see it as an item in the dashboard.

Screenshot of the Chrome Web Store item listing page

You need to fill out additional listing information before you can publish, as contained in the left-hand tabs. Here is a quick summary of the information on these tabs; click through for more detail about how to fill in each tab.

  • The Package tab displays details of your uploaded item. This page isn't editable when you first create an item.
  • The Listing tab contains details of your listing and how it should display in the Chrome Web Store.
  • The Privacy tab is where you include declarations about how your item uses privacy and security related features.
  • The Payment and Distribution tab lets you control which countries will list your item and which set of users will see it.

To publish your item:

  1. Make sure you've completed the details on all the tabs described above.
  2. Click the Submit for Review button.
  3. The following dialog appears, letting you confirm that you want to submit the item for review.
Screenshot of the Chrome Web Store confirm submission dialog

Deferred publishing option

The confirmation dialog shown above also lets you control the timing of your item's publishing. If you uncheck the checkbox, your item will not be published immediately after its review is complete. Instead, you'll be able to manually publish it at a time of your choosing once the review is complete.

If you submit your item for review with "Publish automatically" set, you can still turn off automatic publishing using the Defer publish option described below.

Screenshot showing the 'more' menu's defer publish option

This lets you pause the rollout of a submitted item if you discover an error after submitting it or if you simply want to change your rollout time.

Once the review is complete, you will have up to 30 days to publish. After that period expires, the staged submission will revert to a draft which will have to be submitted again for review. You can check when your staged submission will expire under the status of your item.

Chrome Web Store staged item status

Review of submitted items

After you submit the item for review, it will undergo a review process. The time for this review depends on the nature of your item. See review times for more details.

There are important emails like take down or rejection notifications that are enabled by default. To receive an email notification when your item is published or staged, you can enable notifications in the Account page.

Screenshot of enable staged and reviewed items

Additional resources

Updated on Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.