GH-PROJECT-FIELD-CREATE(1)

💅 GH-PROJECT-FIELD-CREATE(1) 💅

okay bestie, so this is a page straight out of the GitHub CLI manual (yes, the GitHub CLI manual, capital letters, very official) and it's literally all about making a brand-new field inside a project. like, you're decorating your project board and this is the command that hands you the glue gun. 🎀

---

✨ NAME ✨

gh-project-field-create — create a field in a project. that's it. that's the whole gig. 💖

---

🌸 SYNOPSIS 🌸

gh project field-create [<number>] [flags]

the <number> is optional (it's in square brackets, bestie, so it's a vibe, not a demand) and then you sprinkle flags on top like little stickers. 🦋

---

👑 OPTIONS 👑

• --data-type <string> — the DataType of the new field, and no you can't freestyle this one, it has to be one of these exact four: {TEXT|SINGLE_SELECT|DATE|NUMBER}. pick your fighter. 🥊
• --format <string> — output format, and your only option here is {json}. that's the whole menu. 💀
• -q, --jq <expression> — filter that JSON output using a jq expression. for when the JSON is giving too much and you need to be selective. 🔥
• --name <string> — name of the new field. yes you have to actually name it, it won't guess. 🙈
• --owner <string> — login of the owner. use "@me" for the current user (that's you, main character 👑).
• --single-select-options <strings> — the options for the SINGLE_SELECT data type. this is where the dropdown menu content lives. multiple strings, so bring a list. 🌈
• -t, --template <string> — format JSON output using a Go template. also, go read "gh help formatting", that's literally the instruction, i'm just passing it along. 🫶

---

⭐ EXIT CODES ⭐

listen, when the command finishes it tells you how it went, and here's the legend:

• 0 — Successful execution ✨ slay, it worked.
• 1 — Error 😭 something went sideways.
• 2 — Command canceled 🫠 you (or the universe) backed out.
• 4 — Authentication required 🔐 like, who even are you? log in first.

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information. so basically this list is the standard lineup, but individual commands can have their own little extra lore. check the command's help, iykyk. 📖

---

🧚 EXAMPLE 🧚

first up, creating a field in the current user's project "1":

# Create a field in the current user's project "1"
$ gh project field-create 1 --owner "@me" --name "new field" --data-type "text"

and then the glow-up version — a field with three options to select from, for owner monalisa:

# Create a field with three options to select from for owner monalisa
$ gh project field-create 1 --owner monalisa --name "new field" --data-type "SINGLE_SELECT" --single-select-options "one,two,three"

see how the options are one comma-separated string? "one,two,three". observed. noted. ate. 💅

---

💜 SEE ALSO 💜

• gh-project(1) — the parent page, go say hi, it's the whole project family. 🫶

---

aaaand that's the page!! no cap, every flag got its moment. 🎀

sign-off time: this delicious little manual page is from GitHub CLI v2.102.0, dated Oct 2026 — so like, future vibes, iconic behavior, periodt. 🌟💖