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

P4 for Visual Studio Documentation | 2025.1

# Edit changelists

P4 for Visual Studio lets you edit both pending and submitted changelists. You can edit and perform actions on a pending changelist using the Pending tool window and the Pending Changelist dialog. You can also edit details in changelists that have already been submitted using the Submitted tool window and the Submitted Changelist dialog.

To work with changelists from the Pending tool window:

1. Go to View > Pending Changelists to open the Pending window. Alternatively, in the status bar, click 1 Pending Change or X Pending Changes.

2. Right-click the changelist, a file, or an associated job and select any of the following actions:

   These menu items are dynamic. Some only appear for numbered changelists or when you have P4 Code Review installed.

   Item to right-click | Action | More information
   --- | --- | ---
   Pending changelist | Submit | Opens the Submit Files dialog. See Check in files.
   Revert Unchanged Files, or Revert Files | Reverts all files in the changelist that have not been modified, or all files in the changelist, regardless of whether they have been modified or not. See Check in files.
   Move All Files to Another Changelist | Opens a dialog that lets you select a different changelist. See Move a file to another changelist.
   Shelve files | Opens the Shelve dialog. See Shelve files.
   Submit Shelved Files | Silently submits the files. See Submit shelved files.
   Unshelve Files | Opens the Unshelve dialog. See Unshelve files.
   Delete Shelved Files | Deletes the shelved copies of files. P4 for Visual Studio prompts you for confirmation.
   Diff Files Against Have Revisions | Opens both file revisions in P4 Merge. See Compare files using diff.
   New Pending Changelist | Opens the Pending Changelist dialog.
   Edit Pending Changelist | Opens the Pending Changelist dialog.
   Request New Swarm Review or Update a Swarm Review | See Work with reviews in P4 Code Review.
   Change Ownership | Opens a dialog that lets you set the user and workspace.
   Refresh Pending Changelist List, or Refresh Pending Changelist | Updates the Pending tool window or the pending changelist that you have selected.
   File or files in a pending changelist | Submit | Opens the Submit Files dialog. See Check in files.
   Revert | Reverts the selected file or files. See Check in files.
   Move to Another Changelist | Opens a dialog that lets you select a different changelist. See Move a file to another changelist.
   Shelve | Opens the Shelve dialog. See Shelve files.
   Diff Against Have Revision, or Diff Against another revision | Opens the workspace revision and have revision side by side in P4 Merge, or opens the Diff dialog. See Compare files using diff.
   Change filetype | Opens the Change Filetype dialog. See Change P4 Server file types.
   Lock | Locks a file to prevent others from checking it out while you are working on it. See Check out and edit files.
   New Pending Changelist | Opens the Pending Changelist dialog. See Edit changelists.
   Refresh Pending Changelist List | Updates the Pending tool window or the pending changelist that you have selected.
   Job in a pending changelist | Remove from Changelist | Removes the job from the changelist, but does not delete it.

To edit a changelist from the Pending Changelist dialog:

1. Go to View > Pending Changelists to open the Pending tool window. Alternatively, in the status bar, click 1 Pending Change or X Pending Changes.

2. Right-click the changelist in the viewer and select Edit Pending Changelist changelist name to open the Pending Changelist dialog.

   In the Pending Changelist dialog, you can view workspace and user information at the top.

3. To limit who can view the changelist, select the Restrict access to changelist check box. See also Restrict access to changelists.
4. Provide a description for the changelist.

5. Under Files, right-click and select a menu option to do any of the following:

   - Select files for inclusion
   - Move files to another changelist
   - Revert files
   - Unshelve, delete, or view shelved files
   - Attach or view associated jobs
   - Perform a diff on a file pending submission by right-clicking the file and selecting Diff Against Have Revision. To learn more, see Compare files using diff.
6. Under Jobs, view and add associated jobs, or remove jobs.
7. Click OK to save your changes.

To work with changelists from the Submitted tool window:

1. Go to View > Submitted Changelists to open the Submitted window.

2. Right-click the changelist, a file, or an associated job and select any of the following actions.

   Item to right-click | Action | More information
   --- | --- | ---
   Submitted changelist | Get Revision | Opens the Get Revision dialog. See Retrieve files from the depot.
   Edit Submitted Changelist | Opens the Submitted Changelist dialog. See Edit changelists.
   Refresh Submitted Changelist List, or Refresh Submitted Changelist | Updates the Submitted tool window or the submitted changelist that you have selected.
   File in a submitted changelist | Diff Against Previous Revision | Opens both file revisions in P4 Merge. See Compare files using diff.
   Job in a pending changelist | Remove from Changelist | Removes the job from the changelist, but does not delete it.

To edit a changelist from the Submitted Changelist dialog:

1. Go to View > Submitted Changelists to open the Submitted tool window.

2. Right-click the changelist in the viewer and select Edit Submitted Changelist changelist name to open the Submitted Changelist dialog.

   In the Submitted Changelist dialog, you can view workspace and user information at the top.

3. To limit who can view the changelist, select the Restrict access to changelist check box. See also Restrict access to changelists.
4. If needed, edit the description for the changelist.

5. [P4VS-2888]Under Files, right-click a file and do any of the following:

   - Select Diff Against Have Revision to compare the submitted file against the have revision. To learn more, see Compare files using diff.
   - Select File History to open the File History dialog. To learn more, see Display the revision history of a file or folder.
   - Select Time-lapse View to open the Time-lapse View window. To learn more, see View file history with Time-lapse View.
6. Under Jobs, view and add associated jobs, or remove jobs.
7. Click OK to save your changes.

Your search for returned results