The Robocopy documentation for the option /it is simply “Includes ‘tweaked’ files”. What does “tweaked” mean?

The Robocopy documentation for the option /xl is simply “Excludes ‘lonely’ files and directories”. What does “lonely” mean?

up vote 97 down vote accepted


A Tweaked file is defined to be one that exists in both the source and destination, with identical size and timestamp, but different attribute settings.


A "lonely" file is present in source but not destination; excluding lonely will prevent any new files being added to the destination.

"Extra" (the other one that isn't explained well):

An "extra" file is present in destination but not source; excluding extras will prevent any deletions from the destination.

More info here.

  • 3
    I think the reply about "extras" is a bit misleading. It does not necessary delete files in the destination just because its listing extras? – Brimstedt Nov 2 '12 at 12:11
  • 6
    According to the documentation, no action is ever performed on "Extra" files. They are simply reported in the program output log. If you include the switch "/XX" then they are not even reported in the program output. I don't know if it actually works that way, but no reason to doubt it... I have never tried it as a test case. – Kevin Fegan Nov 28 '12 at 18:57
  • 5
    The /PURGE option will remove files that are no longer in the source (along with the /MIR option). Granted, I don't know what /XX /PURGE would end up doing... – Richard Jul 26 '13 at 17:32

"Tweaked", "Lonely", and "Extra" refer to RoboCopy "Classes" of files.

For each directory processed RoboCopy constructs a list of files matching the Include Filespecs, in both the source and destination directories. The program then cross-references these lists, seeing which files exist where, comparing file times and sizes where possible, and places each selected file in one of the following classes:

File        Exists In   Exists In        Source/Dest     Source/Dest   Source/Dest
Class       Source      Destination      File Times      File Sizes    Attributes
=========== =========== ================ =============== ============= ============
Lonely      Yes         No               n/a             n/a           n/a
Tweaked     Yes         Yes              Equal           Equal         Different
Same        Yes         Yes              Equal           Equal         Equal
Changed     Yes         Yes              Equal           Different     n/a
Newer       Yes         Yes              Source > Dest   n/a           n/a
Older       Yes         Yes              Source < Dest   n/a           n/a
Extra       No          Yes              n/a             n/a           n/a
Mismatched  Yes (file)  Yes (directory)  n/a             n/a           n/a

By default, Lonely files (and directories) are always copied, unless /XL switch is used. Changed, Newer and Older files will be considered to be candidates for copying (subject to further filtering described below), Same files will be skipped (not copied), and Extra and Mismatched files (and directories) will simply be reported in the output log.

Normally, Tweaked files are neither identified nor copied – they are usually identified as Same files by default. Only when switch /IT is used will the distinction between Same and Tweaked files be made, and only then will Tweaked files be copied.

Use the following switches to override this default behaviour:

Switch   Function
======== =====================
/XL      eXclude Lonely files and directories.
/IT      Include Tweaked files.
/IS      Include Same files.
/XC      eXclude Changed files.
/XN      eXclude Newer files.
/XO      eXclude Older files.

Use the following switch to suppress the reporting and processing of Extra files:  
/XX      eXclude eXtra files

I found documentation for RoboCopy versions XP010 (Windows XP) and 1.70. If I find documentation for versions XP026 or XP027 (Windows 7), I will link to them here.

Edit (danpritts) - They don't specify the version number of robocopy but here are (less detailed) Windows 7/8/2008/2012 robocopy Docs

  • @Kevin, Wow, this is good stuff dude. Btw, is there a place to download old versrions of RoboCopy? – Pacerier May 4 '16 at 3:12
  • @Pacerier - You can get a copy of Robocopy.exe from the "Windows Server 2003 Resource Kit Tools" by downloading rktools.exe here: . This contains Robocopy Version XP010. If you don't want to install the full package, just UNZIP rktools.exe into a temporary folder. This will extract rktools.msi (and 2 ".cab" files), then UNZIP rktools.msi. You will get Robocopy (Version XP010) and Robocopy.doc. – Kevin Fegan May 8 '16 at 2:25
  • @Pacerier - You can also get a copy of Robocopy.exe Version XP026 which is included in the Robocopy GUI here:… – Kevin Fegan May 8 '16 at 2:25

protected by Community Jan 26 '15 at 8:47

Thank you for your interest in this question. Because it has attracted low-quality or spam answers that had to be removed, posting an answer now requires 10 reputation on this site (the association bonus does not count).

Would you like to answer one of these unanswered questions instead?

Not the answer you're looking for? Browse other questions tagged or ask your own question.