Variable: org-resource-download-policy

org-resource-download-policy is a customizable variable defined in org.el.gz.

Value

prompt

Documentation

The policy applied to requests to obtain remote resources.

This affects keywords like #+setupfile and #+include on export, org-persist-write:url,and org-attach-url in non-interactive Emacs sessions.

This recognizes four possible values:
- t, remote resources should always be downloaded.
- prompt, you will be prompted to download resources not considered safe.
- safe, only resources considered safe will be downloaded.
- nil, never download remote resources.

A resource is considered safe if it matches one of the patterns in org-safe-remote-resources.

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

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defcustom org-resource-download-policy 'prompt
  "The policy applied to requests to obtain remote resources.

This affects keywords like #+setupfile and #+include on export,
`org-persist-write:url',and `org-attach-url' in non-interactive
Emacs sessions.

This recognizes four possible values:
- t, remote resources should always be downloaded.
- prompt, you will be prompted to download resources not considered safe.
- safe, only resources considered safe will be downloaded.
- nil, never download remote resources.

A resource is considered safe if it matches one of the patterns
in `org-safe-remote-resources'."
  :group 'org
  :package-version '(Org . "9.6")
  :type '(choice (const :tag "Always download remote resources" t)
                 (const :tag "Prompt before downloading an unsafe resource" prompt)
                 (const :tag "Only download resources considered safe" safe)
                 (const :tag "Never download any resources" nil)))