Registry / devops / chrome-webstore-upload-cli

chrome-webstore-upload-cli

library3.5.0jsnpmunverified

CLI tool for uploading, updating, and publishing Chrome Extensions to the Chrome Web Store. The current stable version is 3.5.0, requiring Node >=18. The v4 pre-release (v4.0.0-0) requires Node 20+ and removes CLI flags for secrets, using only environment variables. Key differentiators: it's a simple, single-purpose CLI that automates packaging and deployment, supporting both .zip and .crx files. The project has frequent minor releases (3.0.0 went stable in late 2022) and is actively maintained by Fregante. Alternatives like chrome-webstore-upload (programmatic) or web-ext have different focus areas.

devops http-networking

npm install chrome-webstore-upload-cli

github ↗package ↗

INSTALL

IMPORT

SIG · CHROME-WEBSTORE-UP

chrome-webstore-upload-cli

devopsjavascriptv3.5.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

bin (CLI)

✓ npx chrome-webstore-upload-cli --help

✗ require('chrome-webstore-upload-cli')

This package is a CLI binary, not a library. Use npx or install globally.

CLI commands

✓ chrome-webstore-upload upload --source=extension.zip --extension-id=xxx --client-id=...

✗ chrome-webstore-upload --source=...

Since v3.4.0, commands are 'upload', 'publish', or no command (does both). The source flag is only for upload command.

Sets required environment variables and uploads a zip file to the Chrome Web Store.

export CHROME_WEBSTORE_EXTENSION_ID=abc123def456 CHROME_WEBSTORE_CLIENT_ID=your-client-id CHROME_WEBSTORE_CLIENT_SECRET=your-client-secret CHROME_WEBSTORE_REFRESH_TOKEN=your-refresh-token npx chrome-webstore-upload-cli upload --source extension.zip

chrome-webstore-upload --version

Debug

Known issues

breakingv4.0.0-0 requires Node 20+

fix

Upgrade Node.js to version 20 or later.

affects: >=4.0.0-0

breakingv4.0.0-0 removes CLI flags for secrets; use environment variables only

fix

Set CHROME_WEBSTORE_CLIENT_ID, CHROME_WEBSTORE_CLIENT_SECRET, CHROME_WEBSTORE_REFRESH_TOKEN, and CHROME_WEBSTORE_EXTENSION_ID as env variables.

affects: >=4.0.0-0

breakingv3.0.0 requires Node 18+

fix

Upgrade Node.js to version 18 or later.

affects: >=3.0.0 <4.0.0

deprecated--auto-publish flag removed in v4

fix

Use just `chrome-webstore-upload` (no command) to upload and publish in one step.

affects: >=4.0.0-0

gotcha--source flag is forbidden when using the publish command; use upload or no command

fix

Use `chrome-webstore-upload upload --source=file` or `chrome-webstore-upload publish` (no --source).

affects: >=4.0.0-0

Errors

Common errors & fixes

Error: The --source flag can only be used with the 'upload' command

Using --source with 'publish' command (v4+)

fix

Use `chrome-webstore-upload upload --source=file` to upload, then `chrome-webstore-upload publish` to publish.

Error: Missing required environment variable: CHROME_WEBSTORE_CLIENT_ID

Secrets not set (v4+ only ENV) or wrong variable name

fix

Set the required environment variables: CHROME_WEBSTORE_CLIENT_ID, CHROME_WEBSTORE_CLIENT_SECRET, CHROME_WEBSTORE_REFRESH_TOKEN, and CHROME_WEBSTORE_EXTENSION_ID.

Error: source file not found: extension.zip

The --source path is incorrect or the file doesn't exist

fix

Check the path passed to --source; it can be relative or absolute. Ensure the file exists.

Upgrade

Version history

3.5.0latest on npm

Audit

Dependencies

chrome-webstore-uploadrequiredprogrammatic upload logic

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/fregante/chrome-webstore-upload-cli ↗

packagehttps://www.npmjs.com/package/chrome-webstore-upload-cli ↗