gplay releases promote
Copy the latest release on --from to --to, keeping the same versionCode.
Targeting production defaults to a draft release (ADR-0002) unless --complete or --staged is supplied. Release notes carry over from the source unless --release-notes / --release-notes-dir is passed.
When the source track has multiple coexisting releases (e.g. inProgress + halted), pass --version-code N or --release-name <name> to pick one.
gplay releases promote [flags]| Flag | Description |
|---|---|
--complete | force the release status to completed (1.0 user fraction) |
--confirm | explicit confirmation required when promoting to production with --complete / --staged |
--draft | force the release status to draft on the destination |
--dry-run | validate inputs and preview the release payload without any HTTP call |
--from string | source track to promote from |
--keep-edit-on-failure | skip the auto-discard cleanup on failure (debug) |
--output string | output format: table, json, or markdown (default: auto — table on TTY, json in pipes/CI) |
--package string | Android package name (overrides .gplay/config.json pin) |
--release-name string | pick the source release with this name (disambiguator) |
--release-notes string | override carry-over with this text (applied to the app's default language) |
--release-notes-dir string | override carry-over with per-locale files (<locale>.txt, optional default.txt) |
--staged float | start a staged rollout at this fraction (0 < f ≤ 1.0) |
--to string | destination track to promote to |
--version-code int | pick the source release with this versionCode (disambiguator) |
Global flags
Section titled “Global flags”| Flag | Description |
|---|---|
--account string | name of a stored Account to use (overrides env and active Account) |
--retry int | retry transient failures (transport errors, 5xx, 429) up to N times with exponential backoff (default: 0, no retry) |
--service-account string | path to a service-account JSON, or inline JSON content (overrides --account, env, and active Account) |
--timeout duration | per-request API timeout, e.g. 30s or 2m (default: 60s for control-plane calls, none for uploads) |
-v, --verbose | log flow steps to stderr (info level) |