extension-publishing

Workflow

prepare → package → submit → review → publish

1. Prepare: assets, privacy policy, permission justifications, manifest
2. Package:

   zip

   source (exclude dev files), validate manifest
3. Submit: Chrome Web Store Developer Dashboard
4. Review: 1–3 days typical; up to 7 days for new publishers
5. Publish: auto or manual rollout

Pre-Submission Checklist (Quick)

• Manifest v3 only (MV2 deprecated)

• name

  ,

  version

  ,

  description

  set in manifest
• Icons: 16×16, 48×48, 128×128 PNG
• Screenshots: min 1, 1280×800 or 640×400
• Single purpose clearly defined
• Only permissions actually used
• Privacy policy URL (required if collecting data)
• Permission justification field filled for sensitive perms
• No remote code execution (

  eval

  , remote scripts)
• All features functional in review build

Top 10 Rejection Reasons

1. Single purpose violation — does too many unrelated things
2. Excessive/unnecessary permissions
3. Missing privacy policy (required when user data collected)
4. Missing permission justification in submission form
5. Description doesn't match functionality
6. Keyword spam in title/description
7. Remote code execution (

   eval

   , external scripts)
8. Improper user data handling or disclosure
9. Extension non-functional or crashes
10. Broken features / inaccessible links

Listing Optimization Essentials

• Title:

  <Action verb> + <Benefit>

  , max 45 chars, no keyword stuffing
• Description first 150 chars: shown in search — make them count
• Structure: problem → solution → key benefits → CTA
• Screenshots: annotate features, show real UI, 1280×800
• Category: choose most specific fit

CI/CD with chrome-webstore-upload

Install

npm install -g chrome-webstore-upload-cli

Upload & Publish

# Upload new version
chrome-webstore-upload upload \
  --source extension.zip \
  --extension-id $EXT_ID \
  --client-id $CLIENT_ID \
  --client-secret $CLIENT_SECRET \
  --refresh-token $REFRESH_TOKEN

# Publish
chrome-webstore-upload publish \
  --extension-id $EXT_ID \
  --client-id $CLIENT_ID \
  --client-secret $CLIENT_SECRET \
  --refresh-token $REFRESH_TOKEN

Required Env Vars

EXT_ID

CLIENT_ID

CLIENT_SECRET

REFRESH_TOKEN

Plasmo Built-in Publishing

plasmo build           # Build for production
plasmo package         # Create store-ready zip

Reference Files