Variable: url-privacy-level

url-privacy-level is a customizable variable defined in url-vars.el.gz.

Value

(email)

Documentation

How private you want your requests to be.

HTTP has header fields for various information about the user, including operating system information, email addresses, the last page you visited, etc. This variable controls how much of this information is sent.

This should a symbol or a list. Valid values if a symbol are:
none -- send all information
low -- don't send the last location
high -- don't send the email address or last location
paranoid -- don't send anything

If a list, this should be a list of symbols of what NOT to send. Valid symbols are:
email -- the email address (in Emacs 29 or older)
os -- the operating system info
emacs -- the version of Emacs
lastloc -- the last location (see also url-lastloc-privacy-level)
agent -- do not send the User-Agent string
cookies -- never accept HTTP cookies

Emacs 30 and newer never includes the email address in the User-Agent string. If you expect to use older versions of Emacs, it is recommended to always customize this list to include email.

Samples:

 (setq url-privacy-level 'high)
 (setq url-privacy-level '(email lastloc)) ;; equivalent to 'high
 (setq url-privacy-level '(email lastloc os emacs))

::NOTE::
This variable controls several other variables and is _NOT_ automatically updated. Call the function url-setup-privacy-info after modifying this variable.

Probably introduced at or before Emacs version 26.1.

Source Code

;; Defined in /usr/src/emacs/lisp/url/url-vars.el.gz
(defcustom url-privacy-level '(email)
  "How private you want your requests to be.
HTTP has header fields for various information about the user, including
operating system information, email addresses, the last page you visited, etc.
This variable controls how much of this information is sent.

This should a symbol or a list.
Valid values if a symbol are:
none     -- send all information
low      -- don't send the last location
high     -- don't send the email address or last location
paranoid -- don't send anything

If a list, this should be a list of symbols of what NOT to send.
Valid symbols are:
email    -- the email address (in Emacs 29 or older)
os       -- the operating system info
emacs    -- the version of Emacs
lastloc  -- the last location (see also `url-lastloc-privacy-level')
agent    -- do not send the User-Agent string
cookies  -- never accept HTTP cookies

Emacs 30 and newer never includes the email address in the
User-Agent string.  If you expect to use older versions of Emacs,
it is recommended to always customize this list to include `email'.

Samples:

 (setq url-privacy-level \\='high)
 (setq url-privacy-level \\='(email lastloc))    ;; equivalent to \\='high
 (setq url-privacy-level \\='(email lastloc os emacs))

::NOTE::
This variable controls several other variables and is _NOT_ automatically
updated.  Call the function `url-setup-privacy-info' after modifying this
variable."
  :initialize #'custom-initialize-default
  :set (lambda (sym val) (set-default sym val) (url-setup-privacy-info))
  :type '(radio (const :tag "None (you believe in the basic goodness of humanity)"
		       :value none)
		(const :tag "Low (do not reveal last location)"
		       :value low)
		(const :tag "High (no email address or last location)"
		       :value high)
		(const :tag "Paranoid (reveal nothing!)"
		       :value paranoid)
		(checklist :tag "Custom"
			   (const :tag "Email address" :value email)
			   (const :tag "Operating system" :value os)
			   (const :tag "Emacs version" :value emacs)
			   (const :tag "Last location" :value lastloc)
			   (const :tag "Browser identification" :value agent)
                           (const :tag "No cookies" :value cookies)))
  :group 'url)