Next: , Previous: , Up: Org Setup   [Index]


2.2 Global Defaults

org-agenda-inhibit-startup

Inhibit startup when preparing agenda buffers. Current value is ‘nil’.

When this variable is ‘t’, the initialization of the Org agenda buffers is inhibited (variable ‘org-startup-folded’ is ignored): e.g. the visibility state is not set, the tables are not re-aligned, etc.

org-display-custom-times

Non-‘nil’ means overlay custom formats over all time stamps. Current value is ‘nil’. Per-file setting:

#+STARTUP: customtime

The formats are defined through the variable ‘org-time-stamp-custom-formats’.

org-footnote-auto-adjust

Non-nil means automatically adjust footnotes after insert/delete. Default value is ‘nil’. Current value is ‘t’.

When this is t, after each insertion or deletion of a footnote, simple ‘fn:N’ footnotes will be renumbered, and all footnotes will be sorted. If you want to have just sorting or just renumbering, set this variable to ‘sort’ or ‘renumber’. Per-file settings:

#+STARTUP: fnadjust | nofnadjust
org-footnote-auto-label

Non-‘nil’ means define automatically new labels for footnotes. Current valus is ‘t’. Possible values are:

  • nil’ : Prompt the user for each label.
  • t’: Create unique labels of the form ‘[fn:1]’, ‘[fn:2]’, etc.
  • confirm’ : Like t, but let the user edit the created value.
  • random’ : Automatically generate a unique, random label.
org-footnote-define-inline

Non-‘nil’ means define footnotes inline, at reference location. Current value is ‘nil’. When ‘nil’, footnotes will be defined in a special section near the end of the document. When ‘t’, the ‘[fn:label:definition]’ notation will be used to define the footnote at the reference position.

org-hide-block-startup

Non-‘nil’ means entering Org mode will fold all blocks. Current value is ‘nil’. Per-file settings:

#+STARTUP: hideblocks | showblocks
org-hide-leading-stars

Non-‘nil’ means hide the first N-1 stars in a headline. Default value is ‘nil’. Per-file settings:

#+STARTUP: hidestars | showstars
org-log-done

Information to record when a task moves to the DONE state.

Possible values are:

nil

Don’t add anything, just change the keyword

time

Add a time stamp to the task

note

Prompt for a note and add it with template ‘org-log-note-headings’

org-log-note-clock-out

Non-‘nil’ means record a note when clocking out of an item. Current value is ‘nil’. Per-file settings:

#+STARTUP: lognoteclock-out | nolognoteclock-out
org-log-repeat

Non-‘nil’ means record moving through the DONE state when triggering repeat. Current value is ‘time’. Possible values are:

  • nil’ don’t force a record
  • time’ record a time stamp
  • note’ prompt for a note and add it with template ‘org-log-note-headings

This variable forces taking a note.

Per-file settings are:

#+STARTUP: nologrepeat | logrepeat | lognoterepeat

You can have local logging settings for a subtree by setting the LOGGING property to one or more of these keywords.

org-odd-levels-only

Non-‘nil’ means skip even levels and only use odd levels for the outline. Current value is ‘nil’. Per-file settings:

#+STARTUP: odd | oddeven
org-pretty-entities

Non-‘nil’ means show entities as UTF8 characters. Default value is ‘nil’. Current value is ‘t’. Per-file settings:

#+STARTUP: entitiespretty | entitiesplain
org-put-time-stamp-overlays
org-tag-alist

Default tags available in Org files. Current value is ‘nil’. The value of this variable is an ‘alist’. One of:

(TAG) a string
(TAG . SELECT) a character
(SPECIAL)

where ‘SPECIAL’ is one of

:startgroup | :startgrouptag | :grouptags | :endgroup | :endgrouptag | :newline

These keywords are used to define a hierarchy of tags.

Per-file setting:

#+TAGS: tag1 tag2
org-time-stamp-custom-formats

Custom formats for time stamps. See ‘format-time-string’ for the syntax. These are overlaid over the default ISO format if the variable ‘org-display-custom-times’ is set.

org-startup-align-all-tables

Non-nil means align all tables when visiting a file. Current value is ‘nil’. Per-file settings:

#+STARTUP: align | noalign
org-startup-folded

Non-‘nil’ means entering Org mode will switch to OVERVIEW. Current value is ‘t’. Per-file settings:

#+STARTUP: fold (overview) | nofold (showall) | content | showeverything
org-startup-indented

Non-‘nil’ means turn on ‘org-indent-mode’ on startup. Default value is ‘nil’. Current value is ‘Globally’ (i.e., ‘t’). Per-file settings:

#+STARTUP: indent
#+STARTUP: noindent
org-startup-shrink-all-tables

Non-nil means shrink all table columns with a width cookie. Current value is ‘nil’. Per-file setting:

#+STARTUP: shrink
org-startup-with-inline-images

Non-nil means show inline images when loading a new Org file. Current value is ‘nil’. Per-file settings:

#+STARTUP: inlineimages | noinlineimages
org-time-stamp-custom-formats

Custom formats for time stamps. See the function ‘format-time-string’ for the syntax.

Current value is: ("<%m/%d/%y %a>" . "<%m/%d/%y %a %H:%M>")

These are overlaid over the default ISO format if the variable ‘org-display-custom-times’ is set.

org-time-stamp-rounding-minutes

Number of minutes to round time stamps to. Default value was ‘(0 5). Current value is =(6 6)’.

These are two values, the first applies when first creating a time stamp. The second applies when changing it with the commands ‘S-up’ and ‘S-down’. When changing the time stamp, this means that it will change in steps of N minutes, as given by the second value. When a setting is 0 or 1, insert the time unmodified.

org-time-stamp-overlay-formats

Not current defined. (org)To turn on custom format overlays over timestamps

org-todo-keywords

List of TODO entry keyword sequences and their interpretation. It is a list of sequences. Current value is: ((sequence "TODO" "DONE")). Refer to Documentation for extensive details. Per-file settings:

#+TODO:
#+SEQ_TODO:

Next: In-Buffer Settings, Previous: Global Keys, Up: Org Setup   [Index]