It is often useful to associate reference material with an outline node/task.
Small chunks of plain text can simply be stored in the subtree of a project.
Hyperlinks (see Hyperlinks) can establish associations with
files that live elsewhere on your computer or in the cloud, like emails or
source code files belonging to a project. Another method is attachments,
which are files located in a directory belonging to an outline node. Org
uses directories named by the unique ID of each entry. These directories are
located in the data directory which lives in the same directory where
your Org file lives95. If you initialize this directory with
git init, Org will automatically commit changes when it sees them.
The attachment system has been contributed to Org by John Wiegley.
In cases where it seems better to do so, you can also attach a directory of your choice to an entry. You can also make children inherit the attachment directory from a parent, so that an entire subtree uses the same attached directory.
The following commands deal with attachments:
The dispatcher for commands related to the attachment system. After these keys, a list of commands is displayed and you must press an additional key to select a command:
Select a file and move it into the task’s attachment directory. The file
will be copied, moved, or linked, depending on
Note that hard links are not supported on all systems.
Attach a file using the copy/move/link method. Note that hard links are not supported on all systems.
Create a new attachment as an Emacs buffer.
Synchronize the current task with its attachment directory, in case you added attachments yourself.
Open current task’s attachment. If there is more than one, prompt for a
file name first. Opening will follow the rules set by
For more details, see the information on following hyperlinks
(see Handling links).
Also open the attachment, but force opening the file in Emacs.
Open the current task’s attachment directory.
Also open the directory, but force using
dired in Emacs.
Select and delete a single attachment.
Delete all of a task’s attachments. A safer way is to open the directory in
dired and delete from there.
Set a specific directory as the entry’s attachment directory. This works by
putting the directory path into the
ATTACH_DIR_INHERIT property, so that children will use the
same directory for attachments as the parent does.
If you move entries or Org files from one
directory to another, you may want to configure
to contain an absolute path.