datalad-save [-h] [-m MESSAGE] [-d DATASET] [-u] [-a] [--version-tag ID] [-r] [--recursion-limit LEVELS] [-S] [PATH [PATH ...]]


Save the current state of a dataset

Saving the state of a dataset records all changes that have been made to it. This change record is annotated with a user-provided description. Optionally, an additional tag, such as a version, can be assigned to the saved state. Such tag enables straightforward retrieval of past versions at a later point in time.



path/name of the dataset component to save. If given, only changes made to those components are recorded in the new state. 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

-m MESSAGE, –message MESSAGE

a description of the state or the changes made to a dataset. Constraints: value must be a string [Default: None]

-d DATASET, –dataset DATASET

“specify the dataset to save. If a dataset is given, but no FILES, the entire dataset will be saved. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None]

-u, –all-updated

if no explicit paths are given, save changes of all known components in a datasets. [Default: True]

-a, –all-changes

save all changes (even to not yet added files) of all components in datasets that contain any of the given paths [DEPRECATED!]. [Default: None]

–version-tag ID

an additional marker for that state. Constraints: value must be a string [Default: None]

-r, –recursive

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

–recursion-limit LEVELS

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

-S, –super-datasets

if set, save a change in a dataset also in its superdataset. [Default: False]


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