GIT-CHECK-MAILMAP(1) Git Manual GIT-CHECK-MAILMAP(1)

# [NAME](#NAME)

git-check-mailmap - Show canonical names and email addresses of contacts

# [SYNOPSIS](#SYNOPSIS)

```
git check-mailmap [<options>] <contact>...
```

# [DESCRIPTION](#DESCRIPTION)

For each “Name &lt;user@host&gt;”, “&lt;user@host&gt;”, or “user@host” from the command-line or standard input (when using **--stdin**), look up the person’s canonical name and email address (see "Mapping Authors" below). If found, print them; otherwise print the input as-is.

# [OPTIONS](#OPTIONS)

--stdin

Read contacts, one per line, from the standard input after exhausting contacts provided on the command-line.

--mailmap-file=&lt;file&gt;

In addition to any configured mailmap files, read the specified mailmap file. Entries in this file take precedence over entries in either the default mailmap file or any configured mailmap file.

--mailmap-blob=&lt;blob&gt;

Like **--mailmap-file**, but consider the value as a reference to a blob in the repository. If both **--mailmap-file** and **--mailmap-blob** are specified, entries in **--mailmap-file** will take precedence.

# [OUTPUT](#OUTPUT)

For each contact, a single line is output, terminated by a newline. If the name is provided or known to the *mailmap*, “Name &lt;user@host&gt;” is printed; otherwise only “&lt;user@host&gt;” is printed.

# [CONFIGURATION](#CONFIGURATION)

See **mailmap.file** and **mailmap.blob** in [**git-config**(1)](/man/os/git/git-config.1) for how to specify a custom **.mailmap** target file or object.

# [MAPPING AUTHORS](#MAPPING_AUTHORS)

See [**gitmailmap**(5)](/man/os/git/gitmailmap.5).

# [GIT](#GIT)

Part of the [**git**(1)](/man/os/git/git.1) suite

2026-09-28 Git 2.56.0.1.gaef21129

---

Document: git-check-mailmap(1) from git 2.56.0-r2 (Chainguard OS)
Source: https://kernel.googlesource.com/pub/scm/git/git.git