GH-PROJECT-FIELD-CREATE(1) GitHub CLI manual GH-PROJECT-FIELD-CREATE(1)

# [NAME](#NAME)

gh-project-field-create - Create a field in a project

# [SYNOPSIS](#SYNOPSIS)

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

# [OPTIONS](#OPTIONS)

[**--data-type** **<string>**](#data_type)

DataType of the new field.: {TEXT|SINGLE\_SELECT|DATE|NUMBER}

[**--format** **<string>**](#format)

Output format: {json}

[**-q**, **--jq** **<expression>**](#q)

Filter JSON output using a jq expression

[**--name** **<string>**](#name)

Name of the new field

[**--owner** **<string>**](#owner)

Login of the owner. Use "@me" for the current user.

[**--single-select-options** **<strings>**](#single_select_options)

Options for SINGLE\_SELECT data type

[**-t**, **--template** **<string>**](#t)

Format JSON output using a Go template; see "gh help formatting"

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# [EXAMPLE](#EXAMPLE)

```
# Create a field in the current user's project "1"
$ gh project field-create 1 --owner "@me" --name "new field" --data-type "text"
# 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 ALSO](#SEE_ALSO)

[**gh-project(1)**](/man/os/gh/gh-project.1)

Sep 2026

---

Document: gh-project-field-create(1) from gh 2.102.0-r0 (Chainguard OS)
Source: https://github.com/cli/cli