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



NAME
       gh-issue-edit - Edit issues



SYNOPSIS
       gh issue edit {<numbers> | <urls>} [flags]



DESCRIPTION
       Edit one or more issues within the same repository.


       Editing issues' projects requires authorization with the project scope.
       To authorize, run gh auth refresh -s project.


       The --add-assignee and --remove-assignee flags both support the
       following special values: - @me: assign or unassign yourself -
       @copilot: assign or unassign Copilot (not supported on GitHub
       Enterprise Server)



OPTIONS
       --add-assignee <login>
              Add assigned users by their login. Use "@me" to assign yourself,
              or "@copilot" to assign Copilot.


       --add-blocked-by <number>
              Add 'blocked by' relationships by issue number or URL


       --add-blocking <number>
              Add 'blocking' relationships by issue number or URL


       --add-label <name>
              Add labels by name


       --add-project <title>
              Add the issue to projects by title


       --add-sub-issue <number>
              Add sub-issues by number or URL


       -b, --body <string>
              Set the new body.


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


       -m, --milestone <name>
              Edit the milestone the issue belongs to by name


       --parent <number>
              Set the parent issue by number or URL


       --remove-assignee <login>
              Remove assigned users by their login. Use "@me" to unassign
              yourself, or "@copilot" to unassign Copilot.


       --remove-blocked-by <number>
              Remove 'blocked by' relationships by issue number or URL


       --remove-blocking <number>
              Remove 'blocking' relationships by issue number or URL


       --remove-label <name>
              Remove labels by name


       --remove-milestone
              Remove the milestone association from the issue


       --remove-parent
              Remove the parent issue


       --remove-project <title>
              Remove the issue from projects by title


       --remove-sub-issue <number>
              Remove sub-issues by number or URL


       --remove-type
              Remove the issue type from the issue


       -t, --title <string>
              Set the new title.


       --type <name>
              Set the issue type by name



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
       $ gh issue edit 23 --title "I found a bug" --body "Nothing works"
       $ gh issue edit 23 --add-label "bug,help wanted" --remove-label "core"
       $ gh issue edit 23 --add-assignee "@me" --remove-assignee monalisa,hubot
       $ gh issue edit 23 --add-assignee "@copilot"
       $ gh issue edit 23 --add-project "Roadmap" --remove-project v1,v2
       $ gh issue edit 23 --milestone "Version 1"
       $ gh issue edit 23 --remove-milestone
       $ gh issue edit 23 --body-file body.txt
       $ gh issue edit 23 34 --add-label "help wanted"
       $ gh issue edit 23 --type Bug
       $ gh issue edit 23 --remove-type
       $ gh issue edit 23 --parent 100
       $ gh issue edit 23 --remove-parent
       $ gh issue edit 100 --add-sub-issue 123,124
       $ gh issue edit 123 --add-blocked-by 200 --add-blocking 300,301




SEE ALSO
       gh-issue(1)

                                   Jul 2026                   GH-ISSUE-EDIT(1)