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

P4 CLI Documentation | 2025.2

# p4 reviews

List the users who are subscribed to review files.

## Syntax

    p4 reviews [-C client] [-c changelist# | file ...]

Syntax and naming conventions

## Description

The `p4 reviews` command is intended for use in external programs that call P4 Server.

Users subscribe to review files by providing file patterns in the `Reviews` field in their `p4 user` form.

See the Examples below.

### Notification of changes

Some users might want to be made aware of when certain files are changed.

- To subscribe to review files, issue the p4 user command and edit the `Reviews` field to include the path to the files to be watched.

- Swarm must also be configured for notifications of committed changes.

## Options

Option | Description
--- | ---
`-C client` | Limits the files to those opened in the specified client workspace. When used with the `-c` option, limits the workspace to files opened in the specified changelist.
`-c change` | Limits the files to the submitted changelist.
`g-opts` | See Global options.

## Usage notes

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

- The syntax `p4 reviews -c changelist file...` ignores the file arguments entirely.

- p4 reviews is an unusual command. It was created to support external daemons, but it does nothing without the `Reviews` field of the `p4 user` form, which has a very specific meaning.

  It is possible to enter values in the `Reviews` field that mean something originally unintended by P4 Server to create more generalized daemons. At Perforce, for example, we run a jobs daemon that sends email to any users who have subscribed to review jobs when a new job is submitted. Because there is nothing built into P4 Server that allows users to subscribe to review jobs, we co-opt a single line of the `Reviews` field: P4 Server sends a job email to any users who have subscribed to review the non-existent path `//depot/jobs/`.

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

## Examples

`p4 reviews` | Lists all users who have subscribed to review any files.
p4 reviews -c change | Lists each user who has subscribed to review any of the files included in the submitted changelist `change`.
`p4 reviews file ...` | Lists the users who have subscribed to review any files that match the file patterns provided as arguments.

## Related commands

To subscribe to review files | `p4 user`
List all submitted changelists above a provided changelist number | `p4 review`
To set or read the value of a P4 Server counter | `p4 counter`
To read full information about a particular changelist | `p4 describe`

Your search for returned results