GNU ELPA - org


Outline-based notes management and organizer
org-9.5.5.tar, 2022-Sep-03, 8.62 MiB
Bastien Guerry <>
Browse ELPA's repository
CGit or Gitweb

To install this package, run in Emacs:

M-x package-install RET org RET

Full description

-*- mode: org; fill-column:70 -*-

This is a distribution of Org, a plain text notes and project planning
tool for Emacs.

Check the Org Mode website at and the installation
instructions at

* Contents of this distribution

- README :: This file.

- COPYING :: The GNU General Public License.

- Makefile :: The makefile to compile and install Org.  See the
  installation instructions
  or this more detailed procedure on Worg:
- mk/ :: Files needed for building Org.

- lisp/ :: Directory with all the Emacs Lisp files that make up Org.

- doc/ :: The documentation files.  org.texi is the source of the
  documentation, org.html and org.pdf are formatted versions of it.

- etc/ :: Files needed for the ODT exporter.

- testing/ :: Testing suite for Org.

- request-assign-future.txt :: The form that contributors have to sign
  and get processed with the FSF before contributed changes can be
  integrated into the Org core.  All files in this distribution have
  copyright assigned to the FSF.

* Join the GNU Project

Org is part of GNU Emacs and GNU Emacs is part of the GNU Operating
System, developed by the GNU Project.

If you are the author of an awesome program and want to join us in
writing Free (libre) Software, please consider making it an official
GNU program and become a GNU Maintainer.  Instructions on how to do
this are here

Don't have a program to contribute?  Look at all the other ways to

And to learn more about Free (libre) Software in general, please read
and share this page:

* License

Org-mode is published under the GNU GPLv3 license or any later
version, the same as GNU Emacs:

Org-mode is free software: you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation, either version 3 of the License, or (at your
option) any later version.

GNU Emacs is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
General Public License for more details.

You should have received a copy of the GNU General Public License
along with Org mode.  If not, see

Old versions

org-9.5.4.tar.lz2022-Jun-031.44 MiB
org-9.5.3.tar.lz2022-Apr-191.44 MiB
org-9.5.2.tar.lz2021-Dec-241.44 MiB
org-9.5.1.tar.lz2021-Nov-281.44 MiB
org-9.5.tar.lz2021-Sep-291.44 MiB
org-9.4.6.tar.lz2021-May-191.38 MiB
org-9.4.5.tar.lz2021-Mar-281.38 MiB
org-9.4.4.tar.lz2020-Dec-221.38 MiB
org-9.4.3.tar.lz2020-Dec-221.91 MiB
org-9.4.2.tar.lz2020-Dec-131.23 MiB
org-9.4.tar.lz2020-Sep-141.23 MiB
org-9.3.8.tar.lz2020-Sep-071.21 MiB
org-9.3.1.tar.lz2019-Dec-261.21 MiB
org-9.3.tar.lz2019-Dec-051.21 MiB
org-9.2.6.tar.lz2019-Sep-041.19 MiB
org-9.2.tar.lz2018-Dec-311.18 MiB
org-9.1.14.tar.lz2018-Aug-271.17 MiB
org-9.1.9.tar.lz2018-Mar-271.17 MiB
org-9.1.8.tar.lz2018-Mar-261.17 MiB
org-9.1.7.tar.lz2018-Mar-211.17 MiB


ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-

#+STARTUP: overview

#+LINK: doc
#+LINK: msg
#+LINK: git

Copyright (C) 2012-2022 Free Software Foundation, Inc.
See the end of the file for license conditions.

Please send Org bug reports to

* Version 9.5

** Important announcements and breaking changes

*** The =contrib/= now lives in a separate repository

Org's repository has been trimmed from the =contrib/= directory.

The old contents of the =contrib/= directory now lives in a separate
repository at

You can install this repository by cloning it and updating your
~load-path~ accordingly.  You can also install =org-contrib= as a
[[][NonGNU ELPA]] package.

*** Org ELPA and Org archives won't be available for Org > 9.5

[[][Org ELPA]] is still available for installing Org 9.5, either with or
without contributed packages, but future versions won't be available
via Org ELPA, as we are deprecating this installation method.

Also, Org 9.5 is available as =tar.gz= and =zip= archives, but this
installation method is also deprecated.

If you want to install the latest stable versions of Org, please use
the GNU ELPA package.  If you want to install the contributed files,
please use the NonGNU ELPA package.  If you want to keep up with the
latest unstable Org, please install from the Git repository.

See for the details.

*** =ditaa.jar= is not bundled with Org anymore

=ditaa.jar= used to be bundled with Org but it is not anymore.
See [[][the ditaa repository]] on how to install it.

*** ~org-adapt-indentation~ now defaults to =nil=

If you want to automatically indent headlines' metadata, set it to

If you want to automatically indent every line to the headline's
current indentation, set it to =t=.

Indent added by =RET= and =C-j= also depends on the value of
~electric-indent-mode~.  Enabling this mode by default in 9.4 revealed
some bugs caused confusing behavior.  If you disabled
~electric-indent-mode~ for this reason, it is time to try it again.
Hopefully problems have been fixed.  See [[][this FAQ]] for more details.

*** ~org-speed-commands-user~ is obsolete, use ~org-speed-commands~

Setting ~org-speed-commands-user~ in your configuration won't have any
effect.  Please set ~org-speed-commands~ instead, which see.

*** Some =ob-*.el= files have been moved to the org-contrib repo

These files have been moved to

- ob-abc.el
- ob-asymptote.el
- ob-coq.el
- ob-ebnf.el
- ob-hledger.el
- ob-io.el
- ob-J.el
- ob-ledger.el
- ob-mscgen.el
- ob-picolisp.el
- ob-shen.el
- ob-stan.el
- ob-vala.el

See the discussion [[][here]].

*** Compatibility with Emacs versions

We made it explicit that we aim at keeping the latest stable version
of Org compatible with at least Emacs V, V-1 and V-2, where V is the
stable major version of Emacs.

For example, if the current major version of Emacs is 28.x, then the
latest stable version of Org should be compatible with Emacs 28.x,
27.x and 26.x – but not with Emacs 25.x.

See [[][this note on Worg]] and [[git::519947e508e081e71bf67db99e27b1c171ba4dfe][this commit]].

*** The keybinding for ~org-table-blank-field~ has been removed

If you prefer to keep the keybinding, you can add it back to
~org-mode-map~ like so:

#+begin_src emacs-lisp
(define-key org-mode-map (kbd "C-c SPC") #'org-table-blank-field)

** New features

*** New citation engine

Org 9.5 provides a new library =oc.el= which provides tooling to
handle citations in Org, e.g., activate, follow, insert, and export