GH-ALIAS-IMPORT(1) GitHub CLI manual GH-ALIAS-IMPORT(1)

# [NAME](#NAME)

gh-alias-import - Import aliases from a YAML file

# [SYNOPSIS](#SYNOPSIS)

**gh alias import \[<filename> | -] \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Import aliases from the contents of a YAML file.

Aliases should be defined as a map in YAML, where the keys represent aliases and the values represent the corresponding expansions. An example file should look like the following:

```
bugs: issue list --label=bug
igrep: '!gh issue list --label="$1" | grep "$2"'
features: |-


    issue list


    --label=enhancement
```

Use **-** to read aliases (in YAML format) from standard input.

The output from **gh alias list** can be used to produce a YAML file containing your aliases, which you can use to import them from one machine to another. Run **gh help alias list** to learn more.

# [OPTIONS](#OPTIONS)

[**--clobber**](#clobber)

Overwrite existing aliases of the same name

# [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)

```
# Import aliases from a file
$ gh alias import aliases.yml
# Import aliases from standard input
$ gh alias import -
```

# [SEE ALSO](#SEE_ALSO)

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

Sep 2026

---

Document: gh-alias-import(1) from gh 2.102.0-r0 (Chainguard OS)
Source: https://github.com/cli/cli