Manage Changelists

A changelist is a set of local changes that have not yet been committed to a VCS repository.

With changelists, you can group changes related to different tasks and commit these sets of changes independently.

Changelists are displayed in the Local Changes tab of the Version Control tool window Alt+9. Initially, there is a single Default Changelist. It is displayed in bold to show its active status, which means that all new changes are automatically placed in this changelist. There is also an Unversioned Files changelist that groups newly created files that haven't been added to your VCS yet.

You can create as many changelists as needed and make any of them active at any moment. You can move any uncommitted changes to any changelist.

Create a new changelist

Open the Version Control tool window Alt+9 and switch to the Local Changes tab.
Click on the toolbar and select New Changelist.
In the New Changelist dialog, specify the name of the new changelist, and an optional description.

Set the active changelist

Open the Version Control tool window Alt+9 and switch to the Local Changes tab.
Select a non-active changelist and press Ctrl+Space or right-click it and choose Set Active Changelist from the context menu. All new changes will be automatically placed in this changelist.

Move changes between changelists

Open the Version Control tool window Alt+9 and switch to the Local Changes tab.
Select the changes that you want to move to another changelist.
Right-click the selection or click on the toolbar and choose Move to Another Changelist Shift+Alt+M.
In the dialog that opens, select an existing changelist or enter the name for a new changelist.
You can choose to make the target changelist active and to track context for it (MPS will save the context associated with this changelist, and will restore it when this changelist becomes active).

Last modified: 28 February 2020