Skip to content

gplay metadata images validate

Lint the Store images under --dir without contacting Google Play: checks exact dimensions (icon 512×512, feature graphic 1024×500, TV banner 1280×720), screenshot side range (320–3840 px) and 2:1 aspect ratio, format (PNG/JPEG only, read from the bytes), per-image byte size, and per-slot count (≤8).

This command is OFFLINE — no credentials, no network — so it is safe in a pre-commit hook or a CI gate. Diffing the tree against what is live on Play is the job of gplay metadata images apply --dry-run.

The rules are a versioned in-code table (Play's commit is the ultimate authority); images apply --no-validate bypasses this check. Any violation exits 20.

gplay metadata images validate [flags]
FlagDescription
--dir stringpath to the metadata tree to lint (default "./metadata")
--output stringoutput format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI)
FlagDescription
--account stringname of a stored Account to use (overrides env and active Account)
--retry intretry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry)
--service-account stringpath to a service-account JSON, or inline JSON content (overrides --account, env, and active Account)
--timeout durationper-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads)
-v, --verboselog flow steps to stderr (info level)