# @percy/cli-upload

> Percy CLI command to upload a directory of static images to Percy for diffing.

Latest version **1.32.11** (published 2026-09-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install @percy/cli-upload
pnpm add @percy/cli-upload
yarn add @percy/cli-upload
bun add @percy/cli-upload
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.32.11 |
| Published | 2026-09-24 |
| First published | 2020-07-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 87 |
| Maintainers | percy-admin |

## Links

- npm: https://www.npmjs.com/package/@percy/cli-upload
- Repository: https://github.com/percy/cli
- Homepage: https://github.com/percy/cli#readme
- Issues: https://github.com/percy/cli/issues
- npm.io page: https://npm.io/package/@percy/cli-upload

## Recent versions

- 1.32.11 (latest) — 2026-09-24
- 1.32.12-beta.4 (beta) — 2026-10-21
- 1.31.15-alpha.0 (alpha) — 2026-05-21
- 1.32.12-beta.3 — 2026-10-16
- 1.32.12-beta.2 — 2026-10-09
- 1.32.12-beta.1 — 2026-10-06
- 1.32.12-beta.0 — 2026-10-01
- 1.32.11-beta.2 — 2026-09-22
- 1.32.11-beta.1 — 2026-09-22
- 1.32.11-beta.0 — 2026-09-21
- 1.32.10 — 2026-09-17
- 1.32.10-beta.1 — 2026-09-11
- 1.32.10-beta.0 — 2026-09-08
- 1.32.9 — 2026-09-08
- 1.32.9-beta.1 — 2026-09-08
- … 391 more at https://npm.io/package/@percy/cli-upload/versions

## README

# @percy/cli-upload

Percy CLI command to upload a directory of static images to Percy for diffing.

## Commands
<!-- commands -->
* [`percy upload`](#percy-upload)

### `percy upload`

Upload a directory of images to Percy

```
Usage:
  $ percy upload [options] <dirname>

Arguments:
  dirname                 Directory of images to upload

Options:
  -f, --files [pattern]   One or more globs matching image file paths to upload (default:
                          "**/*.{png,jpg,jpeg}")
  -i, --ignore <pattern>  One or more globs matching image file paths to ignore
  -e, --strip-extensions  Strips file extensions from snapshot names

Percy options:
  -c, --config <file>     Config file path
  -d, --dry-run           Print snapshot names only

Global options:
  -v, --verbose           Log everything
  -q, --quiet             Log errors only
  -s, --silent            Log nothing
  -l, --labels <string>   Associates labels to the build (ex: --labels=dev,prod )
  -h, --help              Display command help

Examples:
  $ percy upload ./images
```
<!-- commandsstop -->

## Percy Configuration

This CLI plugin adds the following Percy configuration options (defaults shown).

```yaml
# defaults
version: 2
upload:
  strip-extensions: false
  files: '**/*.{png,jpg,jpeg}'
  ignore: ''
```

- **strip-extensions** - Strips file extensions from snapshot names
- **files** - A glob or array of globs matching file paths to upload
- **ignore** - A glob or array of globs matching file paths to ignore

---
_Source: https://npm.io/package/@percy/cli-upload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._