gh-issue-artifact-view(1)

GH-ISSUE-ARTIFACT-VIEW(1) GitHub CLI manual GH-ISSUE-ARTIFACT-VIEW(1)

NAME

gh-issue-artifact-view - View an issue artifact (preview)

SYNOPSIS

gh issue artifact view {<issue> <artifact-number> | <artifact-url>} [flags]

DESCRIPTION

Display an issue artifact's name, type, authors, content, and edit history. A link shows its URL.

Name the artifact by its issue and number, or by its URL. <issue> is an issue number or URL.

By default, the current version is shown. Use --version to show an earlier version from the edit history.

With --web, open a document's page on GitHub, or a link's URL.

OPTIONS

-q, --jq <expression>
Filter JSON output using a jq expression

--json <fields>
Output JSON with the specified fields

-t, --template <string>
Format JSON output using a Go template; see "gh help formatting"

--version <number> (default 0)
Show the version with this number from the edit history

-w, --web
Open a document's page on GitHub, or a link's URL

OPTIONS INHERITED FROM PARENT COMMANDS

-R, --repo <[HOST/]OWNER/REPO>
Select another repository using the [HOST/]OWNER/REPO format

JSON FIELDS

body, bodyHtml, createdAt, creator, description, id, name, number, type, updatedAt, updatedByActor, url, versions

EXIT CODES

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.

EXAMPLE

# View artifact 2 on issue 142
$ gh issue artifact view 142 2
# View an earlier version
$ gh issue artifact view 142 2 --version 5
# View an artifact by its URL
$ gh issue artifact view https://github.com/monalisa/monas-cafe/issues/142/artifacts/3
# Open a link artifact in the browser
$ gh issue artifact view 142 3 --web
# Print an artifact's body
$ gh issue artifact view 142 2 --json body --jq .body

SEE ALSO

gh-issue-artifact(1)

Oct 2026 GitHub CLI v2.103.3