Frequently Asked Questions
This FAQ answers some common questions about the Chrome Web Store. If you don't find your answer here, check the general extension FAQs, how to troubleshoot Chrome Web Store violations, or the chromium-extension group. For additional technical questions and discussion, we recommend Stack Overflow.
Please expand the Table of Contents to quickly navigate this page.
What is the Chrome Web Store?
The Chrome Web Store is an open marketplace for Google Chrome Extensions and Google Chrome Themes, where consumers may browse, install, and purchase items and install them in their browser. These items are built with web technologies and run inside of web browsers.
Why would someone install an extension instead of just using a bookmark or typing in a URL?
Users can use extensions to add new features to existing web apps, get relevant information on pages and get timely notifications about certain events. Installing an extension also allows you to grant it privileges such as unlimited local storage and background pages.
How will users find my extension?
The Chrome Web Store will surface extensions in a variety of ways. Of course, each extension gets a page in the store, which will be searchable via the store and other search engines. There will be category lists in the store, as well as a variety of curated and algorithmically generated lists. We recommend that you broadly promote your extension, through marketing websites and other means, so that users will find your extension even outside of the store.
Why am I being asked to pay a registration fee?
The registration fee helps to prevent fraud in the Chrome Web Store. You need to pay this one-time fee before you can access the Chrome Web Store Developer Dashboard.
If you are already using the developer dashboard but haven't paid this fee yet, you must now pay it in order to continue accessing your developer dashboard. This one-time fee is now part of the standard developer registration process.
Is there an approval process for extensions in the store?
All extensions go through an automated review process and in some cases, an extension will be published without further manual review. There may be some instances in which a manual review will be required before the extension is published based on our program policies. In some cases, where sensitive permissions are requested, review times and/or approval times may be longer.
What types of extensions are not allowed in the store?
While we try to allow most extensions, a small number of extensions are explicitly disallowed in our Developer Terms of Service and Program Policies. Such extensions will be removed when they are brought to our attention.
How do I report an abusive extension?
To report an extension which violates our Terms of Service, locate the corresponding listing in the store and use the "Report abuse" link.
How are items ranked in the store?
Items in the store are ranked or featured in order to make it easier for users to find high quality content. Ranking is performed by a heuristic that takes into account ratings from users as well as usage statistics, such as the number of downloads vs. uninstalls over time.
Other factors include the following:
- The design is pleasant to the eye.
- The item provides a clear purpose and fills a real user need.
- The setup and onboarding flow are intuitive.
- The item is easy to use.
What are "By Google" extensions?
Certain extensions on the Chrome Web Store are marked as "By Google". These extensions have been developed by Google and go through a rigorous review process. You may also search specifically for these extensions by checking the "By Google" checkbox on the search pages.
How are "Featured" items selected?
The Chrome Web Store team occasionally selects interesting listings as "Featured" listings. We're not accepting requests to be featured at this point, since that would quickly become unmanageable. Here are a few tips to increase the likelihood that we'll feature your listing:
- Write a great piece of software
- Make sure your listing looks really nice (nice icon, good descriptions, crisp screenshots and/or videos)
- Promote your listing independently so that it starts to rise in the rankings
How can my extension be selected for a collection?
The collections are curated, and are not intended to be comprehensive. A collection is curated using the ranking criteria already listed and may be selected to provide helpful results for certain circumstantial situations, such as work-from-home extensions. Solicitations to be placed in a collection are not accepted.
How can I provide support for users of my extension?
First you must "Enable User Feedback" in your developer dashboard Account settings.
Can I remove comments from my listing if I believe they are unfair?
No, you can't remove user comments. However, we encourage you to respond to user feedback in the comments to show that you are addressing their concerns.
You may also report fake reviews via the Developer Support Form.
Is there a limit to the number of items I can have on the Chrome Web Store?
You can upload as many items to the Chrome Web Store as you like, but by default, you are limited to having a total of 20 published items at any one time. This limit applies to the sum of your Themes and Chrome Extensions as a total—it is not 20 of each item. If you reach this limit, you may request a limit increase. The Chrome Web Store staff will review your existing items and your developer account history, and if approved, you will be granted an increase. Please note that if your developer account has been suspended in the past, or you have had items taken down previously for policy violations, or your items consistently receive low quality ratings, your request may be denied.
Can I obfuscate my code?
As of October 1st 2018, developers must not obfuscate code or conceal functionality of their extensions. This also applies to any external code or resource fetched by the extension package. For more information, please review our program policies.
The following are some examples of code obfuscation:
- Base 64 encoding
- Character encoding
How do I write an extension?
You can find all the information you need to develop extensions in the Documentation for Chrome extensions developers.
How can I push an update of my code to my users?
To Update your Chrome Web Store item, visit the developer dashboard and click on the listing you wish to update. Once you upload a new version and click Publish, your update will automatically be pushed out to users over the next few hours.
Can I host my own extension?
You can host your own extensions in limited cases, such as for Linux or ChromeOS users. Consider enterprise publishing or developer mode.
Creating a listing
In what format should I upload my code?
To upload an item to the Chrome Web Store, submit a ZIP file containing the files used in your extension. Do not upload a .crx file; the submission will fail.
How long will it take for my listing to appear in the store?
The item won't appear in the web store until it has successfully completed the review process. (Although the item's unique ID is generated as soon as you upload your first zip file.) For further details, see Chrome Web Store Review Times.
Extensions which are published to the same domain as the publisher address may be approved more quickly. Learn more about enterprise publishing.
How can I remove my listing from the store?
Visit the developer dashboard. Click the item you want to remove from the store, so that the edit page for that item appears. Then click the "more options" icon in the top right-hand corner and select Unpublish. Your listing will no longer be visible in the store.
What are the screenshot and text requirements for the store?
How can I export an extension from the store?
Currently we do not support exporting a listing's sources or private key from the store.
Why did I receive a "Cannot parse the manifest" error when uploading my extension?
The manifest file needs to be in JSON format. Most likely, you've included a comment in the manifest file that is not recognized by the Chrome Web Store's JSON parser. Try removing any comments from the manifest file and try re-uploading.
I've verified my domain, and I have a wildcard URL like *://example.com, but the Chrome Web Store is still asking me to verify my domain. What gives?
If you use a wildcard like *://example.com, make sure you have verified both http://example.com and https://example.com.
When I try to upload to the Chrome Web Store, I get this error: "(Server rejected) An error occurred: please try again later." What gives?
This error occasionally occurs if you've been logged into the Chrome Web Store for a long time. If you sign out of your Google Account and then sign back in, you should be able to upload your extension.
Can I control the regions where my extension is listed?
Yes, in the Distribution Tab you can specify which countries will see your item listing in the Chrome Web Store.
How do I localize my listing in the store?
There are three points where you need to localize your extension for listing in a region that isn't your home market.
- Your extension package. See Internationalizing Your Extension for information on localizing your extension's presence inside Chrome.
- Your detailed description
- Your screenshots
How do I localize my detailed description?
You first need to internationalize your extension and specify a "default_locale" attribute in your manifest. Once you upload your internationalized extension, a selection box will appear at the top of your extension listing, allowing you to switch between languages that you support and change the detailed description.
How do I show different screenshot images per region?
Visit your extension page in the Chrome Web Store Developer Dashboard, change the currently selected language to your desired choice (for example "en-GB") and upload a screenshot as normal. Once the image is uploaded you will be presented with an option to "Show this item in all locales" or "Show this item only in the 'en-GB' locale". Select the latter to show the screenshot to only users of the "en-GB" Chrome Web Store.
My item's status says "pending review." What does this mean?
This means that you've submitted your item for publishing and it is currently in the queue to be reviewed. The item will not appear in the store until it passes this review.
How long will it take to review my item?
Review times vary; some reviews complete in a few hours, others take many days, and in some cases a review can take several weeks. Some reasons that an item could require more extensive review include:
- The item is suspected to contain or to be distributed by malware or unwanted software.
- The item is suspected to violate one of the developer program policies.
- The item may have already been previously removed for a legal or policy violation, and has been resubmitted.
- The item requests powerful permissions that require in-depth review.
Note that all item submissions—whether for a new item or an update to an existing one—are subject to the same review process.
If your item's status says "pending review" for more than three weeks, you should contact support.
Why isn't my extension showing up on search?
It depends. There are several reasons why your item may not be showing up in search.
- You just published your extension. It might take a few hours before we index it.
- Your extension manifest version is out of date. Upgrade your item to a current valid manifest version.
- Your extension is not listed in the region you are searching in. Check your geographical distribution in the Distribution Tab.
My extension has been removed from the Chrome Web Store. What should I do?
Extension removals count as strikes against the good standing of your developer account. Multiple or egregious policy violations may result in termination of your developer account.
- For all policy violation extension removals, you will receive a removal notification email with more details in the developer account listed as the owner of the extension. You can also find this information in the Status Tab of your item.
- Please make the appropriate changes so your extension complies with all Developer Program Policies, Branding Guidelines and Terms of Services. For additional help, see the Troubleshooting violations FAQ.
- Once you have remedied the violation you can resubmit via your developer dashboard.
- Please do not re-publish a removed extension until the policy violation has been remedied. If you have additional questions, follow the instructions in the CWS Complaint Handling FAQ.
My Chrome Web Store account has been suspended. What should I do?
If you believe your developer account was wrongly terminated, you can appeal here. We will only reinstate accounts if an error was made, and a re-review finds that your account does not violate the developer terms. For more information, check the CWS Complaint Handling FAQ.
How do I link my Play and Chrome Web Store item so that the "Available for Android" link appears on my item detail page?
We regularly run a script that looks for exact matches between the item name and the developer email address in Play and CWS. If there is an exact match, the "Available for Android" link will automatically show up on your item detail page the next time the script runs. At this point, there is no way to enter the information into your listing.
If you continue experiencing issues with your Chrome Web Store item, please contact us with any additional details regarding the problem.
How can I raise P2B concerns?
European developers can raise concerns about clarity of terms, policies, or other Platform To Business related issues by contacting CWS support.