datalad update


datalad update [-h] [-s SIBLING] [--merge] [-d DATASET] [-r] [-R LEVELS] [--fetch-all] [--reobtain-data] [PATH [PATH ...]]


Update a dataset from a sibling.



path to a dataset that shall be updated. Constraints: value must be a string [Default: None]

-h, –help, –help-np

show this help message. –help-np forcefully disables the use of a pager for displaying the help message

-s SIBLING, –sibling SIBLING

name of the sibling to update from. If no sibling is given, updates from all siblings are obtained. Constraints: value must be a string [Default: None]


merge obtained changes from the given or the default sibling. [Default: False]

-d DATASET, –dataset DATASET

“specify the dataset to update. If no dataset is given, an attempt is made to identify the dataset based on the input and/or the current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None]

-r, –recursive

if set, recurse into potential subdataset. [Default: False]

-R LEVELS, –recursion-limit LEVELS

limit recursion into subdataset to the given number of levels. Constraints: value must be convertible to type ‘int’ [Default: None]


this option has no effect and will be removed in a future version. When no siblings are given, an all-sibling update will be performed. [Default: None]


if enabled, file content that was present before an update will be re-obtained in case a file was changed by the update. [Default: False]


datalad is developed by The DataLad Team and Contributors <>.