Skip to main content

9.2.2 Internal archiving

If you want to just switch off—for agenda views—certain subtrees without moving them to a different file, you can use the ‘ARCHIVE’ tag.

A headline that is marked with the ‘ARCHIVE’ tag (see Tags) stays at its location in the outline tree, but behaves in the following way:

  • It does not open when you attempt to do so with a visibility cycling command (see Visibility Cycling). You can force cycling archived subtrees with C-TAB, or by setting the option org-cycle-open-archived-trees. Also normal outline commands, like outline-show-all, open archived subtrees.
  • During sparse tree construction (see Sparse Trees), matches in archived subtrees are not exposed, unless you configure the option org-sparse-tree-open-archived-trees.
  • During agenda view construction (see Agenda Views), the content of archived trees is ignored unless you configure the option org-agenda-skip-archived-trees, in which case these trees are always included. In the agenda you can press v a to get archives temporarily included.
  • Archived trees are not exported (see Exporting), only the headline is. Configure the details using the variable org-export-with-archived-trees.
  • Archived trees are excluded from column view unless the variable org-columns-skip-archived-trees is configured to nil.

The following commands help manage the ‘ARCHIVE’ tag:

C-c C-x a (org-toggle-archive-tag)

Toggle the archive tag for the current headline. When the tag is set, the headline changes to a shadowed face, and the subtree below it is hidden.

C-u C-c C-x a

Check if any direct children of the current headline should be archived. To do this, check each subtree for open TODO entries. If none is found, the command offers to set the ‘ARCHIVE’ tag for the child. If point is not on a headline when this command is invoked, check the level 1 trees.

C-c C-TAB (org-force-cycle-archived)

Cycle a tree even if it is tagged with ‘ARCHIVE’.

C-c C-x A (org-archive-to-archive-sibling)

Move the current entry to the Archive Sibling. This is a sibling of the entry with the heading ‘Archive’ and the archive tag. The entry becomes a child of that sibling and in this way retains a lot of its original context, including inherited tags and approximate position in the outline.