---
name: "glab-work-items-create"
section: "1"
platform: "linux"
package: "glab"
version: "1.126.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/glab-work-items-create"
---

# glab-work-items-create(1)

Create work items in a project or group. (EXPERIMENTAL)

## NAME

glab-work-items-create - Create work items in a project or group. (EXPERIMENTAL)

## SYNOPSIS

**glab work-items create \[flags\]**

## DESCRIPTION

Use **--type** to specify the kind of work item to create. The command uses your repository context to detect scope automatically.

**--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**.

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.

**-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).

## 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
```

## SEE ALSO

**[glab-work-items(1)](/glab-work-items/1.md)**