Variable: org-refile-use-outline-path

org-refile-use-outline-path is a customizable variable defined in org-refile.el.gz.

Value

nil

Documentation

Non-nil means provide refile targets as paths.

So a level 3 headline will be available as level1/level2/level3.

When the value is file, also include the file name (without directory) into the path. In this case, you can also stop the completion after the file name, to get entries inserted as top level in the file.

When full-file-path, include the full file path.

When buffer-name, use the buffer name.

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

Source Code

;; Defined in /usr/src/emacs/lisp/org/org-refile.el.gz
(defcustom org-refile-use-outline-path nil
  "Non-nil means provide refile targets as paths.
So a level 3 headline will be available as level1/level2/level3.

When the value is `file', also include the file name (without directory)
into the path.  In this case, you can also stop the completion after
the file name, to get entries inserted as top level in the file.

When `full-file-path', include the full file path.

When `buffer-name', use the buffer name."
  :group 'org-refile
  :package-version '(Org . "9.6")
  :type '(choice
	  (const :tag "Not" nil)
	  (const :tag "Yes" t)
	  (const :tag "Start with file name" file)
	  (const :tag "Start with full file path" full-file-path)
	  (const :tag "Start with buffer name" buffer-name)
	  (const :tag "Start with document title" title)))