Variable: org-startup-folded

org-startup-folded is a customizable variable defined in org.el.gz.

Value

showeverything

Documentation

Initial folding state of headings when entering Org mode.

Allowed values are:

symbol nofold
  Do not fold headings.

symbol fold
  Fold everything, leaving only top-level headings visible.

symbol content
  Leave all the headings and sub-headings visible, but hide their
  text. This is an equivalent of table of contents.

symbol show2levels, show3levels, show4levels, show5levels
  Show headings up to Nth level.

symbol showeverything (default)
  Start Org mode in fully unfolded state. Unlike all other allowed
  values, this value prevents drawers, blocks, and archived subtrees
  from being folded even when org-cycle-hide-block-startup,
  org-cycle-open-archived-trees, or org-cycle-hide-drawer-startup
  are non-nil. Per-subtree visibility settings (see manual node
  (org)Initial visibility)) are also ignored.

This can also be configured on a per-file basis by adding one of the following lines anywhere in the buffer:

   #+STARTUP: fold (or overview, this is equivalent)
   #+STARTUP: nofold (or showall, this is equivalent)
   #+STARTUP: content
   #+STARTUP: show<n>levels (<n> = 2..5)
   #+STARTUP: showeverything

Set org-agenda-inhibit-startup to a non-nil value if you want to ignore this option when Org opens agenda files for the first time.

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

Source Code

;; Defined in /usr/src/emacs/lisp/org/org.el.gz
(defcustom org-startup-folded 'showeverything
  "Initial folding state of headings when entering Org mode.

Allowed values are:

symbol `nofold'
  Do not fold headings.

symbol `fold'
  Fold everything, leaving only top-level headings visible.

symbol `content'
  Leave all the headings and sub-headings visible, but hide their
  text.  This is an equivalent of table of contents.

symbol `show2levels', `show3levels', `show4levels', `show5levels'
  Show headings up to Nth level.

symbol `showeverything' (default)
  Start Org mode in fully unfolded state.  Unlike all other allowed
  values, this value prevents drawers, blocks, and archived subtrees
  from being folded even when `org-cycle-hide-block-startup',
  `org-cycle-open-archived-trees', or `org-cycle-hide-drawer-startup'
  are non-nil.  Per-subtree visibility settings (see manual node
  `(org)Initial visibility)') are also ignored.

This can also be configured on a per-file basis by adding one of
the following lines anywhere in the buffer:

   #+STARTUP: fold              (or `overview', this is equivalent)
   #+STARTUP: nofold            (or `showall', this is equivalent)
   #+STARTUP: content
   #+STARTUP: show<n>levels (<n> = 2..5)
   #+STARTUP: showeverything

Set `org-agenda-inhibit-startup' to a non-nil value if you want
to ignore this option when Org opens agenda files for the first
time."
  :group 'org-startup
  :package-version '(Org . "9.4")
  :type '(choice
	  (const :tag "nofold: show all" nofold)
	  (const :tag "fold: overview" fold)
	  (const :tag "fold: show two levels" show2levels)
	  (const :tag "fold: show three levels" show3levels)
	  (const :tag "fold: show four levels" show4evels)
	  (const :tag "fold: show five levels" show5levels)
	  (const :tag "content: all headlines" content)
	  (const :tag "show everything, even drawers" showeverything)))