GH-PROJECT-ITEM-EDIT(1)        GitHub CLI manual       GH-PROJECT-ITEM-EDIT(1)



NAME
       gh-project-item-edit - Edit an item in a project



SYNOPSIS
       gh project item-edit [<number>] [flags]



DESCRIPTION
       Edit a draft issue or a project item.


       The usual way to select the item and field is by name: pass the project
       number plus --owner, point at the item with its issue or pull request
       --url, and name the field with --field. For single-select fields,
       --value is the option name.


       For scripts and machine use, you can also pass GraphQL node IDs
       directly with --id, --field-id and --project-id (and, for single-select
       fields, --single-select-option-id).


       Note that --url is the issue or pull request URL, not a project URL, so
       its owner may differ from the project's; --owner selects the project.


       For non-draft issues, only a single field value can be updated per
       invocation.


       Remove a project item field value with --clear.



OPTIONS
       --body <string>
              Body of the draft issue item


       --clear
              Remove field value


       --date <string>
              Date value for the field (YYYY-MM-DD)


       --field <string>
              Name of the field to update


       --field-id <string>
              ID of the field to update


       --format <string>
              Output format: {json}


       --id <string>
              ID of the item to edit


       --iteration-id <string>
              ID of the iteration value to set on the field


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


       --number <float> (default 0)
              Number value for the field


       --owner <string>
              Login of the owner. Use "@me" for the current user.


       --project-id <string>
              ID of the project to which the field belongs to


       --single-select-option-id <string>
              ID of the single select option value to set on the field


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


       --text <string>
              Text value for the field


       --title <string>
              Title of the draft issue item


       --url <string>
              URL of the issue or pull request whose project item to edit


       --value <--field>
              Value to set on the field named by --field



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
       # Set the "Status" field to "In Progress" for an issue on monalisa's project 1
       $ gh project item-edit 1 --owner monalisa --url https://github.com/monalisa/myproject/issues/23 --field "Status" --value "In Progress"

       # Edit an item's text field value by node ID (machine / scripted use)
       $ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --text "new text"

       # Clear an item's field value by node ID
       $ gh project item-edit --id <item-id> --field-id <field-id> --project-id <project-id> --clear




SEE ALSO
       gh-project(1)

                                   Sep 2026            GH-PROJECT-ITEM-EDIT(1)