In-buffer settings start with ‘#+’, followed by a keyword, a colon, and then a word for each setting. Org accepts multiple settings on the same line. Org also accepts multiple lines for a keyword. This manual describes these settings throughout. A summary follows here.
C-c C-c activates any changes to the in-buffer settings. Closing and reopening the Org file in Emacs also activates the changes.
Sets the archive location of the agenda file. The corresponding
Sets the category of the agenda file, which applies to the entire document.
Set the default format for columns view. This format applies when columns view is invoked in locations where no ‘COLUMNS’ property applies.
Set file-local values for constants that table formulas can use.
This line sets the local variable
org-table-formula-constants-local. The global version of this
Set tags that all entries in the file inherit from, including the top-level entries.
Each line specifies one abbreviation for one link. Use multiple
‘LINK’ keywords for more, see Link Abbreviations. The
corresponding variable is
This line sets the limits and the default for the priorities. All three must be either letters A–Z or numbers 0–9. The highest priority must have a lower ASCII number than the lowest priority.
This line sets a default inheritance value for entries in the current buffer, most useful for specifying the allowed values of a property.
The setup file or a URL pointing to such file is for additional in-buffer settings. Org loads this file and parses it for any settings in it only when Org opens the main file. If URL is specified, the contents are downloaded and stored in a temporary file cache. C-c C-c on the settings line parses and loads the file, and also resets the temporary file cache. Org also parses and loads the document during normal exporting process. Org parses the contents of this document as if it was included in the buffer. It can be another Org file. To visit the file—not a URL—use C-c ' while point is on the line with the file name.
Startup options Org uses when first visiting a file.
The first set of options deals with the initial visibility of the
outline tree. The corresponding variable for global default
org-startup-folded with a default value of
which is the same as
Top-level headlines only.
No folding on any entry.
Show even drawer contents.
Dynamic virtual indentation is controlled by the variable
org-indent-mode turned on.
org-indent-mode turned off.
Aligns tables consistently upon visiting a file. The corresponding
nil as default
Align all tables.
Do not align tables on startup.
Shrink table columns with a width cookie. The corresponding
nil as default
When visiting a file, inline images can be automatically displayed.
The corresponding variable is
with a default value
nil to avoid delays when visiting a file.
Show inline images.
Do not show inline images on startup.
Logging the closing and reopening of TODO items and clock
intervals can be configured using these options (see variables
Record a timestamp when an item is marked DONE.
Record timestamp and a note when DONE.
Do not record when items are marked DONE.
Record a time when reinstating a repeating item.
Record a note when reinstating a repeating item.
Do not record when reinstating repeating item.
Record a note when clocking out.
Do not record a note when clocking out.
Record a timestamp when scheduling time changes.
Record a note when scheduling time changes.
Do not record when a scheduling date changes.
Record a timestamp when deadline changes.
Record a note when deadline changes.
Do not record when a deadline date changes.
Record a timestamp when refiling.
Record a note when refiling.
Do not record when refiling.
Here are the options for hiding leading stars in outline headings,
and for indenting outlines. The corresponding variables are
org-odd-levels-only, both with
a default setting
nil (meaning ‘showstars’ and ‘oddeven’).
Make all but one of the stars starting a headline invisible.
Show all stars starting a headline.
Virtual indentation according to outline level.
No virtual indentation according to outline level.
Allow only odd outline levels (1, 3, …).
Allow all outline levels.
To turn on custom format overlays over timestamps (variables
Overlay custom time format.
The following options influence the table spreadsheet (variable
‘constants.el’ should use the c-g-s unit system.
‘constants.el’ should use the SI unit system.
To influence footnote settings, use the following keywords. The
corresponding variables are
Define footnotes inline.
Define footnotes in separate section.
Define footnotes near first reference, but not inline.
Prompt for footnote labels.
Create ‘[fn:1]’-like labels automatically (default).
Offer automatic label for editing or confirmation.
Automatically renumber and sort footnotes.
Do not renumber and sort automatically.
To hide blocks on startup, use these keywords. The corresponding
Hide all begin/end blocks on startup.
Do not hide blocks on startup.
The display of entities as UTF-8 characters is governed by the
org-pretty-entities and the keywords
Show entities as UTF-8 characters where possible.
Leave entities plain.
These lines (several such lines are allowed) specify the valid
tags in this file, and (potentially) the corresponding fast tag
selection keys. The corresponding variable is
These lines set the TODO keywords and their interpretation in the
current file. The corresponding variable is
org-indent-mode also sets the
property, such that
visual-line-mode (or purely setting
wraps long lines (including headlines) correctly indented.