Next: , Previous: , Up: Mastering Org-Mode   [Index]

15 Variables


Non-‘nil’ means dim blocked tasks in the agenda display. Default is non-‘nil’. While this causes some overhead during agenda construction, it can be used to advantage. org-agenda-dim-blocked-tasks


Default value is ‘nil’.

When ‘t’, inhibit startup when preparing agenda buffers (visibility state is not set). Also ignore ‘#+STARTUP:’ setting when ‘t’. The point of this variable is to speed up agenda commands when Org files grow in size and number.


Non-nil means show inherited tags in each agenda line. Default value is ‘t’. May be set to a list of agenda types (same as org-agenda-use-tag-inheritance). When ‘nil’, never show inherited tags in agenda lines.

When this option is set to ‘always’, it takes precedence over ‘org-agenda-use-tag-inheritance’ and inherited tags are shown in every agenda.


Allowed values are one or more of:

  • todo
  • search
  • agenda

Setting this option to ‘nil’ will speed up non-tags agenda views a lot.

List of agenda view types where to use tag inheritance. The default value sets tags in every agenda type, i.e., ‘(todo search agenda)’. You may want the agenda to be aware of the inherited tags anyway, e.g. for later tag filtering.

This variable has no effect if ‘org-agenda-show-inherited-tags’ is set to ‘always’. In that case, the agenda is aware of those tags.


Default arguments to use when evaluating a source block. Babel default. It’s default value is:

((:session . "none")
 (:results . "replace")
 (:exports . "code")
 (:cache . "no")
 (:noweb . "no")
 (:hlines . "no")
 (:tangle . "no"))

Remove code block evaluation from the ‘C-c C-c’ key binding.


Name of the command for executing Python code (i.e., python3)

  • nil’: do not check; just do invisible edits. DEFAULT
  • error’: throw an error and do not edit
  • show’: make point visible, and do the requested edit
  • show-and-error’: make point visible, then throw an error and abort.
  • smart’: make point visible; do edit in some cases; basically, this allows insertion and backward-delete right before ellipses.

    Check if in invisible region before inserting or deleting a character.


Confirm before evaluation. Require confirmation before interactively evaluating code blocks in Org buffers. The default value of this variable is ‘t’.


Non-‘nil’ means ask for confirmation before executing Emacs Lisp links.


Non-‘nil’ means ask for confirmation before executing shell links.


Default value is ‘t’.

Where should org-cycle emulate <TAB>.

  • nil
  • white’ complete white lines
  • whitestart’ beginning of white lines before first char
  • t’ everywhere except headline
  • exc-hl-bol’ everywhere except start of headline

When non-‘nil’, <TAB> at very beginning of file (not on a headline), runs global cycling.

NOTE: This works even if the first line holds a mode line.


When non-‘nil’ and org-mode is called interactively on an empty file, insert ‘-*- mode: org -*-’ into the first line.


List of property/value pairs that can be inherited by any entry. This list will be combined with the constant org-global-properties-fixed.


List of property/value pairs that can be inherited by any entry. These are fixed values, for the preset properties. Use org-global-properties to add to this list.

Its value is:

(("VISIBILITY_ALL" . "folded children content all")
 ("CLOCK_MODELINE_TOTAL_ALL" . "current today repeat all auto"))

Modules that should always be loaded together with org.el.


Non-‘nil’ means entering Org mode will switch to OVERVIEW.


An alist of keys and structure block types used by ‘org-insert-structure-template’ and Org Tempo.


List of tags that should never be inherited. Default value is ‘nil’. Opposite is org-use-tag-inheritance.


Non-‘nil’ means list also sublevels of headlines matching a search. Default value is ‘t’.

When set to the symbol ‘indented’, sublevels are indented with leading dots.

Setting this variable to ‘nil’ causes subtrees of a match to be skipped.

Applies to tags and property searches, and to stuck projects.

NOTE: This variable is semi-obsolete and probably should always be true. It is better to limit inheritance to certain tags using the variables ‘org-use-tag-inheritance’ and ‘org-tags-exclude-from-inheritance’.


This is an alist of KEY characters and corresponding KEYWORDS, just like ‘org-structure-template-alist’. The tempo snippet ‘<KEY’ is expanded.


Non-‘nil’ means properties apply also for sublevels. It is not on by default to prevent slow searches. When ‘nil’, only the properties directly given in the current entry count.

The value may also be a list of properties that should have inheritance, or a regular expression matching properties that should be inherited.

Some special properties use inheritance under special circumstances: CATEGORY, ARCHIVE, COLUMNS, and the properties ending in "_ALL" when they are used as descriptor for valid values of a property.


Non-‘nil’ means tags in levels apply also for sublevels. Default value is ‘t’. If this option is ‘t’, a match early-on in a tree can lead to a large number of matches in the subtree when constructing the agenda or creating a sparse tree. If you only want to see the first match in a tree, see orgs-tags-match-list-sublevels.

When ‘nil’, only the tags directly given in a specific line apply there.

May be a list of tags to be inherited, or a regexp to match tags.

Next: org-element.el, Previous: Reproducible Research, Up: Mastering Org-Mode   [Index]