# phpman > man > GIT-CHECK-MAILMAP(1)

> **TLDR:** Show canonical names and email addresses of contacts.
>
- Look up the canonical name associated with an email address:
  `git check-mailmap {{email@example.com}}`
- Use the specified mailmap file in addition to the defaults:
  `git check-mailmap --mailmap-file {{path/to/file}} {{email@example.com}}`

*Source: tldr-pages*

---

[GIT-CHECK-MAILMAP(1)](https://www.chedong.com/phpMan.php/man/GIT-CHECK-MAILMAP/1/markdown)                         Git Manual                         [GIT-CHECK-MAILMAP(1)](https://www.chedong.com/phpMan.php/man/GIT-CHECK-MAILMAP/1/markdown)



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

## SYNOPSIS
       _git_ _check-mailmap_ [<options>] <contact>...


## DESCRIPTION
       For each “Name <user@host>” 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
### --stdin
           Read contacts, one per line, from the standard input after exhausting contacts provided
           on the command-line.

## OUTPUT
       For each contact, a single line is output, terminated by a newline. If the name is provided
       or known to the _mailmap_, “Name <user@host>” is printed; otherwise only “<user@host>” is
       printed.

## CONFIGURATION
       See **mailmap.file** and **mailmap.blob** in [**git-config**(1)](https://www.chedong.com/phpMan.php/man/git-config/1/markdown) for how to specify a custom **.mailmap**
       target file or object.

## MAPPING AUTHORS
       See [**gitmailmap**(5)](https://www.chedong.com/phpMan.php/man/gitmailmap/5/markdown).

## GIT
       Part of the [**git**(1)](https://www.chedong.com/phpMan.php/man/git/1/markdown) suite



Git 2.34.1                                   02/26/2026                         [GIT-CHECK-MAILMAP(1)](https://www.chedong.com/phpMan.php/man/GIT-CHECK-MAILMAP/1/markdown)