Pull changes from the remote repository

Update a shared project when remote changes are made to the project. Pull changes when the status bar displays
Remote changes available
. When you pull changes, the shared local project updates with changes made to the remote project. Any conflicts between the two versions of the project appear for you to choose which version of a change to keep.
If another user of the shared project performs a Restore, a banner displays the message:
The remote project was restored to a previous state. Pull changes to synchronize your local workspace.
 The
Restore
 option is disabled until you
Pull
 the changes.
Change History
 displays a warning that identifies the commits the other user removed with the
Restore
.
IMPORTANT: Pulled changes cannot be undone. Pull changes only if you want to make the shared project on the local computer the same as the project on the remote repository.
TIP: The number in the icon identifies the total commits made by other users sharing the project (remote commits).
Prerequisite
  • If you made changes to the local project, commit your changes before pulling remote commits. Select Commit icon
    Commit
    , and then select Push icon
    Push
    .
To pull changes from the remote project
:
  1. In the open project, if
    Remote changes available
     appears in the status bar, select Pull icon
    Pull
    or select
    File > Source control > Pull
    . The open project updates with any changes made to the shared project on the remote repository.
    TIP: If the remote version of the shared project has changes to the same content as the local project version,
    Manage conflicts
     opens.
  2. If
    Manage conflicts
     opens, use:
    • Status
       to identify if the file contains conflicts.
    • Path
       to reference the files that have conflicts.
    • Conflicts
       to identify the number of conflicts in a file and
      Total conflicts
       to identify all the known conflicts.
  3. Select each conflict in the table and then select an option above the changed code for the conflict:
    • Accept local change
      . Discard the change made to the remote version of the project and accept the change that appears in the LOCAL CHANGES row of code. This option updates the remote version of project with the change made to the local version of the project.
    • Accept remote change
      . Discard the change made to the local version of the project and accept the change that appears in the SERVER CHANGES row of code. This option updates the local version of the project with the change made to the remote version of the project.
    • Accept both changes
      . Apply the changes in both the LOCAL CHANGES and SERVER CHANGES rows of code.
      TIP: If another user deletes a file remotely from the shared project while
      Manage conflicts
       is open,
      Remote changes available
       appears again.
  4. (optional) After you accept changes, the
    Revert
     button is enabled. Select
    Revert
     if you want to return the files to the previously applied or committed changes.
  5. To manage any remotely removed files, select Pull icon
    Pull
     again and then in the first
    Keep file
     column of
    Manage conflicts
    , either:
    • Select the checkbox to keep the file that the other user removed remotely.
    • Leave the checkbox cleared to remove the file from your local project as well.
  6. When all conflicts are resolved, select
    Accept
    .
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.