The odrive Developer Hub

Welcome to the odrive developer hub. You'll find comprehensive guides and documentation to help you start working with odrive as quickly as possible, as well as support if you get stuck. Let's jump right in!

Get Started    

Sync Source Changes



There is a balance that is struck between what content is local and what is not. The balance is personal, as each individual's needs vary depending on workflow and use case requirements. The starting point for any odrive user is to limit your local content so you can progressively access all content without being constrained by the physical limitations of the Internet and/or your local disk storage. The next point is to enable you to lessen the restrictions by configuring the sync rules applying to your access to content on a global and per-folder basis.


You can decide what is automatically downloaded when you browse into a folder.


By default, odrive sets your auto download limit to "Never download". You can browse odrive, open and download files and folders, all with the familiar single click and double click actions as you need them.

If you wish for files to always download automatically as you browse into a folder, then you can set it to "Always download".


If you wish to constrain what files are automatically downloaded by file size, then you can limit what is downloaded by choosing 10 MB, 100 MB, or 500 MB. The size number is inclusive, meaning, any files 10 MB or bigger is not autodownloaded if you choose 10 MB.


The autodownload limit applies whenever you expand a placeholder folder. Once you have expanded a folder, the autodownload limit, even if changed, will not reapply to the folder, with one exception. It will apply to newly added files in the folder.


You can also decide what is automatically downloaded on a per-folder basis by using the right-click->sync dialog on a folder of your choice. This will sync a folder and download its contents according to your preferences, independent of autodownload limit settings.

Use right-click to sync a folder and download its contents according to your preferences, independent of autodownload limit settings.

If you checkmark both boxes, then every file, folder, and subfolder will be synced locally, including any new files and folders that are added after you apply these settings.

Effectively, this is the mode you want if you want everything in that folder synced locally – and keep in sync locally – even as the folder's content changes.

If you want to exclude files over a certain size, use the slider to set the size limit:

Use the slider bar to determine what files of a certain size or smaller to download

If you don't care about keeping in local sync any newly added files and folders, then keep that box unchecked.

Decide if you want to save the setting to the folder and apply it for new files which get added to the folder.

If you don't care about any subfolders, then make sure that box is unchecked.

Choose if you want to download files and folders in subfolders or not.

As a rule of thumb, odrive will recognize folder settings ahead of autodownload settings.


Conflicts may occur from file naming conventions that a remote source may allow while the computer OS may NOT allow.

odrive reconciles these conflicts by preventing the offending file or folder from showing on the desktop view until you fix the problem on the remote source.

If you see a file on the remote source but not on your desktop client, then you can check for the following potential issues:

  1. Two or more files with the same name in the same path
  2. Illegal characters (e.g. you can not use forward ("/") or backward ("\") slash in name)
  3. Exceeds character length
  4. Reserved file names
  5. Unqualified path

Each of Windows, Mac and Linux has their own set of file names that they do not allow. Here's the link to Windows.

Updated about a year ago

Sync Source Changes

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.