glab(1)

💖 NAME 💖

Okay bestie, welcome to the glab(1) manual — this page is all about glab-work-items-create, aka Create work items in a project or group. (EXPERIMENTAL). Slay. ✨

---

✨ SYNOPSIS ✨

glab work-items create [flags]

🦋 DESCRIPTION 🦋

Use --type to pick what kind of work item you're creating, bestie. The command uses your repository context to detect scope automatically — no cap.

--attach uploads a file and references it at the end of the description. Repeat the flag for more than one file, or pass - to read the file from standard input. Uploads are project-scoped, so --attach cannot be combined with --group. Important, okay? 💅

--parent accepts a work item ID in the current scope, a reference such as group/project#123, or a URL.

⚠️ This feature is an experiment and is not ready for production use. It might be unstable or removed at any time. For more information, see https://docs.gitlab.com/policy/development_stages_support/.

---

🎀 OPTIONS 🎀

• --attach=[] — (EXPERIMENTAL) Upload a file and reference it at the end of the description. Use - to read the file from standard input. Repeat the flag to attach multiple files. 🍓
• -c, --confidential[=false] — Mark work item confidential. 🤫
• -d, --description="" — Description of the work item. Set to - to open an editor.
• --description-file="" — Read the work item description from a file. Use - to read from standard input. 📄
• -g, --group="" — Create work items for a group or subgroup.
• --iteration=0 — Add the work item to the iteration with this ID.
• --jq="" — Filter JSON output with a jq expression.
• -F, --output="text" — Format output as: text, json.
• --parent="" — set the parent work item by , reference, or URL. (Yep, that's exactly how the flag text reads, bestie.)
• -R, --repo="" — Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted. 🌈
• -t, --title="" — Add a title for the work item.
• -T, --type="" — Type of work item (epic, incident, issue, key_result, objective, requirement, task, test_case, ticket). 👑
• -h, --help[=false] — Show help for this command. 🫶

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

• -h, --help[=false] — Show help for this command.

---

🌈 EXAMPLE 🌈

# Create a work item in the current project
glab work-items create --type issue

# Create a work item in a group
glab work-items create --type epic --group my-group

# Read the description from a file
glab work-items create --type issue --title "Add feature" --description-file description.md

# Read the description from standard input
cat description.md | glab work-items create --type issue --title "Add feature" --description-file -

# Attach a screenshot to the description
glab work-items create --type issue --title "Add feature" --attach ./screenshot.png

# Create a work item in an iteration
glab work-items create --type issue --title "Add feature" --iteration 123

# Create a task under work item 42 in the current project
glab work-items create --type task --title "Write tests" --parent 42

# Create a task under a work item in another project
glab work-items create --type task --title "Write tests" --parent my-group/my-project#42

💜 SEE ALSO 💜

glab-work-items(1) — go read that one too, bestie! 🦋

---

Auto generated by spf13/cobra · Nov 2026 · from the glab(1) manual — bye bestie! 💅✨