GH-PROJECT-ITEM-EDIT(1)

✨ gh-project-item-edit(1) ✨

okay so bestie, this is the gh-project-item-edit page from the GitHub CLI manual — v2.102.0 era, October 2026 vibes — and it's literally the glow-up button for a single item in a GitHub project. let's go 💅

---

🌸 NAME 🌸

gh-project-item-edit — edit an item in a project. that's it. that's the whole thing. 🎀

---

🦋 SYNOPSIS 🦋

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

like, you can pass a project number, and you can pass flags. both iconic. both allowed. ✨

---

💖 DESCRIPTION 💖

So what are we even doing here? You're editing a draft issue or a project item. That's the assignment. 🫶

The usual way to select the item and the field is by name, and here's the little recipe: 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. easy peasy, no cap. 👑

For scripts and machine use (iykyk, robot mode 🤖), you can also pass GraphQL node IDs directly with --id, --field-id and --project-id — and, for single-select fields, --single-select-option-id. very main character energy for your automation. ⚡

⚠️ heads up bestie: --url is the issue or pull request URL, not a project URL, so its owner may differ from the project's owner! --owner is what selects the project. don't mix them up, I'm begging 😭

Also super important: for non-draft issues, only a single field value can be updated per invocation. one field. one shot. periodt. 🎯

And when you need to yeet a value? Remove a project item field value with --clear. gone. deleted. not me being dramatic 💀

---

💅 OPTIONS 💅

• --body <string> — the body of the draft issue item. give it some ~content~ ✍️
• --clear — remove the field value. bye bye value 🫡
• --date <string> — date value for the field, formatted YYYY-MM-DD. yes, that exact format, don't get creative 🗓️
• --field <string> — name of the field to update. your friendly human-readable pick 🌸
• --field-id <string> — ID of the field to update. the machine-readable twin 🆔
• --format <string> — output format: {json}. sleek. structured. love that for you ✨
• --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. chef's kiss for pipelines 🧑‍🍳
• --number <float> (default 0) — number value for the field. yes it's a float, yes the default is 0 🔢
• --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. note the cute little <--field> — it's teaming up with its bestie 🫶

---

🎀 EXIT CODES 🎀

vibe check, results edition:

• 0: successful execution — slay! 🎉
• 1: error — it's giving oops 😭
• 2: command canceled — you hit the brakes 🛑
• 4: authentication required — log in first, bestie 🔐

📌 NOTE: specific commands may have additional exit codes. refer to the command's help for more information. always check the receipts 💜

---

🔥 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

ate. no crumbs. 🍓

---

🌈 SEE ALSO 🌈

• gh-project(1) — the whole project family, go say hi 👋

---

💖 that's the whole page, bestie 💖 — brought to you by GitHub CLI v2.102.0, dated October 2026. go edit some items, you absolute icon. 👑🦋✨