gh-project-field-create(1)

gh-project-field-create1

Create a field in a project

Usage

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

Options

--data-type <string>

DataType of the new field.: {TEXT|SINGLE_SELECT|DATE|NUMBER}

--format <string>

Output format: {json}

-q, --jq <expression>

Filter JSON output using a jq expression

--name <string>

Name of the new field

--owner <string>

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

--single-select-options <strings>

Options for SINGLE_SELECT data type

-t, --template <string>

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

Exit status

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.

Examples

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

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.