GH-ISSUE-COMMENT(1)            GitHub CLI manual           GH-ISSUE-COMMENT(1)



NAME
       gh-issue-comment - Add a comment to an issue



SYNOPSIS
       gh issue comment {<number> | <url>} [flags]



DESCRIPTION
       Add a comment to a GitHub issue.


       Without body text or attachments supplied through flags, the command
       will interactively prompt for the comment text.


       Use --attach to upload an image or video. If the body already
       references an attached file, such as ![alt](./login.png), that
       reference is rewritten to point at the uploaded asset. Any attached
       file the body does not reference is appended to the end of the comment.
       You can attach up to 50 files per command.


       Alt text for an image follows the path after #, as in --attach
       './login.png#The login error state'. Without it the filename is used.
       A reference already in the body keeps the alt text written there. Video
       renders as a player and has no alt text, so it cannot be given any.



OPTIONS
       --attach <file>
              Attach an image or video file, in '#' format


       -b, --body <text>
              The comment body text


       -F, --body-file <file>
              Read body text from file (use "-" to read from standard input)


       --create-if-none
              Create a new comment if no comments are found. Can be used only
              with --edit-last


       --delete-last
              Delete the last comment of the current user


       --edit-last
              Edit the last comment of the current user


       -e, --editor
              Skip prompts and open the text editor to write the body in


       -w, --web
              Open the web browser to write the comment


       --yes  Skip the delete confirmation prompt when --delete-last is
              provided



OPTIONS INHERITED FROM PARENT COMMANDS
       -R, --repo <[HOST/]OWNER/REPO>
              Select another repository using the [HOST/]OWNER/REPO format



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
       # Add a comment to an issue
       $ gh issue comment 12 --body "Hi from GitHub CLI"

       # Attach a screenshot, with alt text after "#"
       $ gh issue comment 12 --attach './login.png#The login error state'

       # Attach multiple files by repeating the flag
       $ gh issue comment 12 --attach ./before.png --attach ./after.png




SEE ALSO
       gh-issue(1)

                                   Sep 2026                GH-ISSUE-COMMENT(1)