Skip to main content

Repositories

By default your workspaces are synced in full, but there will be cases when you might want to:
  • pause temporarily the syncing of your workspace.
  • just sync a subset of your workspaces.

Pause workspace sync

You can temporarily pause syncing for any workspace through the desktop app: Open the workspace sync settings: click the ⋯ button to the right of the workspace selector, at the right end of the bar at the top of the repo. Its tooltip reads Workspace sync settings, and the menu is titled This workspace. Toggle Sync off to pause (“Upload and download file changes with the cloud”) In the Pause Workspace Sync dialog, click Pause. To resume, toggle Sync back on in the same menu. While paused: Your local changes are preserved and you can continue working Remote commits from other team members won’t sync to your workspace Your commits won’t be pushed to the repository This is useful when you need to work offline or want to prevent interruptions during intensive work sessions. Remember to resume syncing when you’re ready to collaborate again.

Workspace Automatic Update

While sync pause/resume controls the syncing between your local copy to the cloud workspace, auto-update controls the merging of new commits from the shared branch into your cloud workspace. To change it for a workspace, use the Auto-update toggle (“Apply teammates’ commits to this workspace automatically”) in the same This workspace menu as Sync.

How it works

Auto-Update ON

Remote commits to the current branch will be automatically merged to the cloud workspace.There is no separate update to accept. See what the header shows.

Auto-Update OFF

Remote commits to the current branch will not be automatically merged to the cloud workspace.When the branch has newer commits, the workspace header offers an Update button until you update. See what the header shows.
Toggling auto-update from off to on will trigger an automatic workspace update in case of pending updates.

When should I turn it off?

In most cases it is better to be in sync with the remote branch, it allows finding and fixing conflicts fast and to avoid complex merges in the future. Turn it off if you don’t want remote branch updates to automatically be synced into your cloud workspace, for example if you think that changes from other teammates might break your current project state.

Alternative to disabling auto-update

It is possible to branch-out to a side branch in order to avoid receiving new commits from the shared branch into your local workspace while you are working on a feature or a fix. The advantages of this approach are:
  • You can commit in more granular steps, and retain fine-grained control over your project history.
  • When you are ready to merge your changes into the shared branch, you can create a Review Request to have your changes reviewed by your team members.
  • Whenever you start working on a new feature, you can be sure that you are working on the latest version of the shared branch.

Default automatic update setting

Repo admins and owners can set the default auto-update value of new workspaces created in the selected repo. To change the setting, open the settings sidebar (via your avatar -> Organization settings) and click Repositories under your organization’s section. Use the toggle in the repository’s row, under the Auto-Update column.
This will not affect existing workspaces’ settings. Users can control the auto-update setting for their individual workspaces regardless of the default setting for new workspaces.

Selective sync

Control exactly which folders sync to your local workspace through the workspace sync settings (the ⋯ icon, Workspace sync settings, to the right of the workspace selector; its menu is titled This workspace). Choose Selective sync (“Choose which folders sync to this workspace”) Check (for sync) or uncheck (for unsync) the desired directories and click Save. A save that stops syncing folders asks you to confirm first and lists them. How it works: Checked folders: Contents sync locally, including all subfolders Unchecked folders: Won’t sync locally Partially checked folders: Only checked subfolders will sync Previously synced folders: Will be deleted locally if unchecked Important notes: Selective sync settings apply only to the current workspace Settings cannot be changed while you have pending changes—commit or discard your changes first Each workspace can have different selective sync configurations This feature is particularly useful for large repositories where you only need specific assets or code sections for your current task.

Partially clone a repo with selective sync

You can clone only specific folders from a repository, reducing disk space usage and sync time. Nothing is downloaded for the folders you leave out.
1

Open the clone dialog

On the dashboard’s Remote Repositories tab, click the … button at the right end of the repository’s row and choose Clone repo. The dialog has a Folders to sync row.
2

Choose the folders

Click Choose…, uncheck the folders you do not need, and click Done.
3

Clone

Choose Create New Folder or Create from Existing Folder, click Browse… to pick the location, then click Clone. The workspace is created with your selection.
See Selective Sync for details.