9.1 Refile and Copy

When reviewing the captured data, you may want to refile or to copy some of the entries into a different list, for example into a project. Cutting, finding the right location, and then pasting the note is cumbersome. To simplify this process, you can use the following special command:

C-c C-w (org-refile)

Refile the entry or region at point. This command offers possible locations for refiling the entry and lets you select one with completion. The item (or all items in the region) is filed below the target heading as a subitem. Depending on org-reverse-note-order, it is either the first or last subitem.

By default, all level 1 headlines in the current buffer are considered to be targets, but you can have more complex definitions across a number of files. See the variable org-refile-targets for details. If you would like to select a location via a file-path-like completion along the outline path, see the variables org-refile-use-outline-path and org-outline-path-complete-in-steps. If you would like to be able to create new nodes as new parents for refiling on the fly, check the variable org-refile-allow-creating-parent-nodes. When the variable org-log-refile82 is set, a timestamp or a note is recorded whenever an entry is refiled.

C-u C-c C-w

Use the refile interface to jump to a heading.

C-u C-u C-c C-w (org-refile-goto-last-stored)

Jump to the location where org-refile last moved a tree to.

C-2 C-c C-w

Refile as the child of the item currently being clocked.

C-3 C-c C-w

Refile and keep the entry in place. Also see org-refile-keep to make this the default behavior, and beware that this may result in duplicated ‘ID’ properties.

C-0 C-c C-w or C-u C-u C-u C-c C-w (org-refile-cache-clear)

Clear the target cache. Caching of refile targets can be turned on by setting org-refile-use-cache. To make the command see new possible targets, you have to clear the cache with this command.

C-c M-w (org-refile-copy)

Copying works like refiling, except that the original note is not deleted.

C-c C-M-w (org-refile-reverse)

Works like refiling, except that it temporarily toggles how the value of org-reverse-note-order applies to the current buffer. So if org-refile would append the entry as the last entry under the target header, org-refile-reverse will prepend it as the first entry, and vice-versa.


Footnotes

(82)

Note the corresponding ‘STARTUP’ options ‘logrefile’, ‘lognoterefile’, and ‘nologrefile’.