Variable: org-attach-id-to-path-function-list

org-attach-id-to-path-function-list is a customizable variable defined in org-attach.el.gz.

Value

(org-attach-id-uuid-folder-format org-attach-id-ts-folder-format org-attach-id-fallback-folder-format)

Documentation

List of functions used to derive attachment path from an ID string.

The functions are called with a single ID argument until the return value is an existing folder. If no folder has been created yet for the given ID, then the first non-nil value defines the attachment dir to be created.

Usually, the ID format passed to the functions is defined by org-id-method. It is advised that the first function in the list do not generate all the attachment dirs inside the same parent dir. Some file systems may have performance issues in such scenario.

Care should be taken when customizing this variable. Previously created attachment folders might not be correctly mapped upon removing functions from the list. Then, Org will not be able to detect the existing attachments.

This variable was added, or its default value changed, in Org version
9.6.

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-attach.el.gz
(defcustom org-attach-id-to-path-function-list
  '(org-attach-id-uuid-folder-format
    org-attach-id-ts-folder-format
    org-attach-id-fallback-folder-format)
  "List of functions used to derive attachment path from an ID string.
The functions are called with a single ID argument until the return
value is an existing folder.  If no folder has been created yet for
the given ID, then the first non-nil value defines the attachment
dir to be created.

Usually, the ID format passed to the functions is defined by
`org-id-method'.  It is advised that the first function in the list do
not generate all the attachment dirs inside the same parent dir.  Some
file systems may have performance issues in such scenario.

Care should be taken when customizing this variable.  Previously
created attachment folders might not be correctly mapped upon removing
functions from the list.  Then, Org will not be able to detect the
existing attachments."
  :group 'org-attach
  :package-version '(Org . "9.6")
  :type '(repeat (function :tag "Function with ID as input")))