Helix Core is now P4. Product user interfaces will be updated soon. Learn more >>

P4 CLI Documentation | 2025.2

# p4 branches

List existing branch mappings.

## Syntax

    p4 [g-opts] branches [[-e | -E] nameFilter] [-m max][-t] [-u user [--user-case-insensitive] | --me]

Syntax and naming conventions

## Description

Print the list of all branch mappings currently known to the system.

Use the `-m max` option to limit the output to the first `max` branch mappings.

Use the `-e` or `-E filter` options to limit the output to branches whose name matches the `nameFilter` pattern. The `-e` option is case-sensitive, and `-E` is case-insensitive.

Use the `-u user` option to limit the output to branches owned by the named user.

## Options

Option | Description
--- | ---
`-E filter` | List only branches matching `filter`. Unlike the `-e` option, this option operates in a case-insensitive manner, even on a case-sensitive server.
`-m max` | List only the first `max` branch mappings.
`-t` | Display the time as well as the date of the last update to the branch.
`--me` | Equivalent to `-u $P4USER`.
`g-opts` | See Global options.

### Examples with the * wildcard

If you use the `*` wildcard, enclose the search pattern in double quotes (").

`-e filter` | List only branches matching `filter` (case-sensitive). Lists branch specs with a name that matches the `nameFilter` pattern. For example: `-e "svr-dev-rel*"` Unlike the `-E` option, this option uses the server's normal case-sensitivity rules.

`-u user` | List branch specs owned by the specified user. This can include `*` wildcards to form a search pattern. If wildcards are used, enclose the search pattern in double quotes (`"`). For example: `p4 branches -u "*bert"` You can also add the `--user-case-insensitive` suboption to indicate that the `user` value is a case-insensitive search pattern, even for a case-sensitive server.

## Usage notes

Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required
--- | --- | ---
N/A | N/A | `list`

The command returns no output if there is no object to report on.

## Related commands

To create or edit a branch mapping | `p4 branch`

Your search for returned results