Bookmarks Column/Repository Browser Overview

Summary

This article should help users to understand the UI surrounding the Bookmark feature in SourceTree, and the different manipulations that can be done on the bookmarks:

Solution

Here's how to view and manipulate SourceTree Bookmarks:

For Windows

Viewing the bookmark column

Steps:

1. To show the Bookmarks column in SourceTree, simply click on View, and then click on Show/Hide Bookmarks

Here, you will be introduced to a few buttons:

2. Add Repository button, which has the same function as pressing a Clone/New button to allow you to:

• • Add an existing repository into SourceTree

  • Clone a repository into SourceTree

  • Create a new repository with SourceTree

3. Add Folder button

4. Delete button

5. Show Hosted Repositories button, which allows you to:

• • Viewing Remote Hosted Repositories

Manipulating bookmarks

Add Repository

Once you add a repository into SourceTree either by cloning one from remote, adding an existing one, or creating a brand new one, there should be a repository that appears in the bookmark column:

Add Folder

Clicking the Add Folder icon button will produce a new folder.

Moving a bookmark

You can drag around and rearrange bookmarks, and you can drag a bookmark into a folder:

Steps:

1. Click and hold on to a bookmark.

2. Drag it into a folder

3. Now you'll see that the bookmark is now in the folder.

You'll also notice that you can show and hide the folder contents by just clicking the "+" or "-" sign of the folder respectively.

Delete bookmark

Steps:

1. Click on a bookmark.

2. Click on the Delete icon.

3. A pop-up window should appear to allow the user to confirm the delete.

4. Clicking OK will delete the bookmark for good.

For Mac

Viewing the Repository Browser

Steps:

• To open the repository browser, you can:

  • Click on Window, and then click on Show Repository Browser

  • Click on the SourceTree app icon at the Dock.

There are a few important buttons that comes along with the repository browser:

1. Local

   1. This button allows users to view the list of their local repositories in SourceTree.

2. Remote

   1. This button allows users to view the list of their remote hosted repositories in SourceTree

3. + New Repository

   1. This button allows users to:

      1. Add an existing repository into SourceTree

      2. Clone a repository into SourceTree

      3. Create a new repository with SourceTree

Manipulating repository lists

By right-clicking the repository browser, users should be able to rename, delete a specific repository, as well as sort the repository list according to Name or Type.

Users can rearrange the list by just dragging the repository bookmark around, and create new groups to sort the list into a few groupings:

Steps:

1. Right click at the mouse

2. Click on New Group, and users can name it to anything they desire.

3. Drag a repository bookmark into the group:

4. The repository bookmark is now listed within the new group that is just created.