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.



contrain to-be-updated subdatasets to the given path for recursive operation. Constraints: value must be a string

-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


merge obtained changes from the given or the default sibling.

-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 current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path)

-r, --recursive

if set, recurse into potential subdataset.

-R LEVELS, --recursion-limit LEVELS

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


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.


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


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