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

P4 CLI Documentation | 2026.1

# Displaying file status

To display information about single revisions of files, issue the `p4 files` command. This command displays the locations of the files in the depot, the actions (`add`, `edit`, `delete`, and so on) performed on those files at the specified revisions, the changelists in which the specified file revisions were submitted, and the files' types. The following example shows typical output of the `p4 files` command:

    //depot/README#5 - edit change 6 (text)

The `p4 files` command requires one or more filespec arguments. Regardless of whether you use local, client, or depot syntax to specify the filespec arguments, the `p4 file` command displays results using depot syntax. If you omit the revision number, information for the head revision is displayed. The output of `p4 files` includes deleted revisions.

The following table lists some common uses of the `p4 files` command:

To display the status of | Use this command
--- | ---
All files in the depot, regardless of your workspace view For depots containing numerous files, you can maximize performance by avoiding commands that refer to the entire depot (`//depot/...`) when not required. For best performance, specify only the directories and files of interest. | `p4 files //depot/...`
The files currently synced to the specified client workspace. | `p4 files @workspacename`
The files mapped by your workspace view. | `p4 files //workspacename/...`
Specified files in the current working directory | `p4 files filespec`
A specified file revision | `p4 files filespec#rev`
Specified files at the time a changelist was submitted, regardless of whether the files were submitted in the changelist | `p4 files filespec@changenum`
Files tagged with a specified label | `p4 files filespec@labelname`

Your search for returned results