Chrome Web Store Listing Checklist: Every Field, and What to Write
A field-by-field checklist for your Chrome Web Store listing: name, description, screenshots, privacy and the policy mistakes that get extensions rejected.
By Extension Club3 min read
A rejected or ignored listing usually fails on small, fixable things. Use this as a pre-submission checklist. Limits in this post are the ones published in Chrome's own documentation at the time of writing; check the developer dashboard if a number looks different to you, because requirements can change.
Name
- Limit: up to 75 characters in the manifest
namefield. - Write: your brand plus the job, in plain words people search ("Export Group Members to Excel | Brandname").
- Avoid: another company's trademark, and a pile of keywords separated by pipes. Both are common reasons for rejection or takedown.
Short description (manifest description)
- Limit: 132 characters.
- Write: one sentence on the job, one on the difference. This is the text shown in search results.
- Avoid: marketing adjectives with no content ("powerful, amazing, best").
Detailed description
Describe the extension in plain sentences in this order:
- What it does, in one paragraph.
- How to use it, in three or four short steps.
- What it deliberately does not do (this builds trust and reduces bad reviews).
- Pricing, if there is a paid tier, stated honestly.
The part that gets extensions rejected: keyword spam
This is the most common avoidable rejection we have seen, and we have had it twice. The description was fine except for one block. Two real examples:
- A paragraph listing a long row of brand names the extension worked with (every app and website, comma-separated).
- A "who it's for" section listing professions and audiences.
Both were rejected under the keyword spam policy. The fix was to delete the lists and describe the behaviour in sentences. If you need to name a site for a permission, put it in the permission justification, which is where reviewers expect it, not in the public description.
Screenshots
- Size: 1280 by 800 pixels (or 640 by 400).
- Count: at least one, up to five.
- Content: show the real interface at a realistic state. Use sample data that contains no real people's information.
- Order: the first image carries most of the weight. Put the finished result there.
- Do not crop in a way that hides what the extension actually looks like. A screenshot that does not match the product leads to refunds, bad reviews and sometimes rejection.
Promo images
- Small promo tile: 440 by 280.
- Marquee: 1400 by 560.
These are used when the store features extensions. They are optional for submission but worth preparing.
Category and language
Pick the category where a person looking for your tool would browse, not the one that sounds most impressive. Add translations only if you can maintain them; a listing in a language you cannot support produces support requests you cannot answer.
Permissions and the justification form
For each permission, the dashboard asks you to justify it. Write one honest sentence naming the feature that needs it. Request only what you use. "Access to all websites" for an extension that works on one site is the fastest way to a long review.
Privacy
If your extension collects or transmits any user data, publish a privacy policy and link it. State plainly:
- What is stored on the user's device only.
- What is sent to your servers, and why.
- What you never collect.
- Which third parties, if any, receive data (for example a payment provider).
Then make sure the dashboard's data-use disclosures match the policy and the code. Inconsistencies are a rejection reason.
The final check
Before pressing submit, load the unzipped package into Chrome yourself and click every feature. Every missing file or broken screen found by a reviewer costs you a review cycle that can take days. A build script that refuses to package an extension when a referenced file is missing pays for itself the first time it fires.
After it is live
Add the listing to your website, then launch it on directories and track your keywords. You can list your extension on Extension Club in about a minute: paste your store link and the listing fills itself in.
Keep reading
All guidesHow to Launch a Chrome Extension: A Practical Checklist
A step-by-step checklist for launching a Chrome extension: store listing, review, first users, links and tracking. Based on shipping real extensions.
Where to Submit Your Chrome Extension: Directories, Communities and What Each Gives You
A practical map of where to list and promote a Chrome extension: the store, launch directories, communities and your own site, and what each one is for.
Chrome Web Store SEO: How to Rank Your Extension in Store Search
How Chrome Web Store search works in practice, which parts of your listing matter most, and a repeatable process for improving your extension's rank.