gh-release-upload(1)

gh-release-upload1

Upload assets to a release

Usage

gh release upload <tag> <files> ... [flags]

Overview

Upload asset files to a GitHub Release.

To define a display label for an asset, append text starting with # after the file name.

When using --clobber, existing assets are deleted before new assets are uploaded. If the upload fails, the original assets will be lost.

Options

--clobber

Delete and re-upload existing assets of the same name

Options inherited from parent commands

-R, --repo <[HOST/]OWNER/REPO>

Select another repository using the [HOST/]OWNER/REPO format

Exit status

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.