---
name: "glab-issue-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-issue-create"
---

# glab-issue-create(1)

Create an issue.

## NAME

glab-issue-create - Create an issue.

## SYNOPSIS

**glab issue create \[flags\]**

## DESCRIPTION

Opens an editor to draft the issue unless you pass a title and description. Use **--web** to create the issue in your browser, or **--template** to start from an issue template.

**--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. An attachment satisfies the description requirement, so **--title** with **--attach** completes without prompting.

The **--attach** flag is an experiment. It might be unstable or removed at any time, and is not ready for production use. For more information, see https://docs.gitlab.com/policy/development\_stages\_support/.

The **--recover** flag is an experiment: it might be unstable or removed at any time, and is not ready for production use. For more information, see https://docs.gitlab.com/policy/development\_stages\_support/.

## OPTIONS

**-a**, **--assignee**=\[\]\
 	Assign issue to people by their **usernames**. Multiple usernames can be comma-separated or specified by repeating the flag.

**--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\]\
 	Set an issue to be confidential.

**-d**, **--description**=""\
 	Issue description. Set to "-" to open an editor.

**--description-file**=""\
 	Read the issue description from a file. Use "-" to read from standard input.

**--due-date**=""\
 	A date in 'YYYY-MM-DD' format.

**--epic**=0\
 	ID of the epic to add the issue to.

**-l**, **--label**=\[\]\
 	Add label by name. Multiple labels can be comma-separated or specified by repeating the flag.

**--link-type**="relates\_to"\
 	Type for the issue link.

**--linked-issues**=\[\]\
 	The IIDs of issues that this issue links to. Multiple IIDs can be comma-separated or specified by repeating the flag.

**--linked-mr**=0\
 	The IID of a merge request in which to resolve all issues.

**-m**, **--milestone**=""\
 	The global ID or title of a milestone to assign.

**--no-editor**\[=false\]\
 	Don't open editor to enter a description. If set to true, uses prompt.

**--recover**\[=false\]\
 	Save the options to a file if the issue fails to be created. If the file exists, the options will be loaded from the recovery file. (EXPERIMENTAL)

**--template**=""\
 	Template to pre-populate the description. A name is looked up in '.gitlab/issue\_templates/' of the local repository, and the '.md' extension is optional. A value that is absolute or contains a path separator is read as a file path, for example '~/templates/bug.md'.

**-e**, **--time-estimate**=""\
 	Set time estimate for the issue.

**-s**, **--time-spent**=""\
 	Set time spent for the issue.

**-t**, **--title**=""\
 	Issue title.

**--web**\[=false\]\
 	Continue issue creation with web interface.

**-w**, **--weight**=0\
 	Issue weight. Valid values are greater than or equal to 0.

**-y**, **--yes**\[=false\]\
 	Don't prompt for confirmation to submit the issue.

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

**-R**, **--repo**=""\
 	Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

## EXAMPLE

```
glab issue create
glab issue new
glab issue create -m release-2.0.0 -t "we need this feature" --label important
glab issue new -t "Fix CVE-YYYY-XXXX" -l security --linked-mr 123
glab issue create -m release-1.0.1 -t "security fix" --label security --web --recover
glab issue create -t "Bug Report" --template bug
glab issue create -t "Feature Request" --template feature_proposal.md --yes
# Use a template file from outside the repository
glab issue create -t "Bug Report" --template ~/team-templates/bug.md
# Read the description from a file
glab issue create -t "we need this feature" --description-file description.md
# Read the description from standard input
cat description.md | glab issue create -t "we need this feature" --description-file -
# Attach a screenshot to the description
glab issue create -t "Login button misaligned" -d "See below." --attach ./screenshot.png
```

## SEE ALSO

**[glab-issue(1)](/glab-issue/1.md)**