Skip to content
Tutorials Center
My learning

Topics

Lesson 17 of 38 ยท Org Mode

Org TODO Items, Tags and Properties

Turn Org headings into tasks: TODO and DONE states, custom keyword sequences, priorities, tags, checkbox lists with progress cookies, properties and column-friendly metadata.

An Org heading can be more than a title. Add a keyword such as TODO and it becomes a task; add tags and it can be found by topic; add a property drawer and it can carry any data you like. The agenda in the next lesson reads exactly these pieces, so this lesson sets up everything it will use.

TODO states

Start a heading with a keyword:

ORG
* TODO Write the report
* DONE Book the room
* Notes (no keyword, just a heading)

Put the cursor on a heading and press C-c C-t (org-todo). It cycles through the states: no state, TODO, DONE, no state. Press S-<right> and S-<left> to step forward and backward without a prompt. Setting DONE can also record a time stamp, CLOSED: [2026-11-13 Fri 10:15], if you set (setq org-log-done 'time).

Your own workflow

You can define states per file with #+TODO: lines. Words before the | are active states; words after it are finished states.

ORG
#+TODO: TODO NEXT WAITING | DONE CANCELED

After editing such a line, press C-c C-c on it to reload the setting. Then C-c C-t offers the letters you assigned, or cycles through your list. A shorthand with selection keys adds a one-key choice: #+TODO: TODO(t) NEXT(n) WAITING(w@) | DONE(d!) CANCELED(c@). The suffix @ asks for a note when entering that state and ! records a timestamp. For a global default, set org-todo-keywords in your init file.

JS Stand-in: a TODO state machine

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Priorities

An optional priority cookie [#A] to [#C] goes after the keyword: * TODO [#A] Pay the invoice. Change it with S-<up> and S-<down> while on the heading. The agenda can sort by priority. A task without a cookie gets the default priority (B).

Tags

Tags sit at the end of a heading, between colons: * TODO Fix login bug :work:urgent:. Press C-c C-q (or C-c C-c on a heading) to set tags, with completion over the tags you used before. Tags are inherited by sub-headings: a child of a :work: heading counts as tagged work too. Set file-wide tags with #+FILETAGS: :project:.

Tag names use letters, numbers, _ and @. Declare fixed tags with the #+TAGS: line to get single-key selection:

ORG
#+TAGS: @home(h) @office(o) @phone(p) errand

Tags with @ are used for contexts, a common method for task lists. You can then search all your files for a tag in the agenda with C-c a m.

Checkboxes and progress

List items can be checkboxes: - [ ] item. C-c C-c on one toggles it to [X]. Add a progress cookie to the parent heading or item, [/] for a count or [%] for a percentage, and Org keeps it updated.

ORG
* Release checklist [1/3]
- [X] Update changelog
- [ ] Tag the release
- [ ] Publish notes

Org can also keep a heading's cookie in sync with the TODO states of its children: write * Project [/] and give the subtasks TODO keywords. Setting org-enforce-todo-dependencies to t stops a parent from being marked DONE while children are open.

JS Stand-in: parse headings, tags and progress

Press Run (or Ctrl + Enter) to see the console output here.

No output.

Properties

A property drawer holds key-value data for a heading, directly below it:

ORG
* Book: Structure and Interpretation of Computer Programs
:PROPERTIES:
:AUTHOR: Abelson and Sussman
:PAGES: 657
:STATUS: reading
:END:

Add one with C-c C-x p (org-set-property). Properties are inherited if you enable it, searchable in the agenda (C-c a m accepts property matches such as STATUS="reading"), and the foundation of the column view: C-c C-x C-c shows headings as a table of their properties, defined with #+COLUMNS: %25ITEM %AUTHOR %PAGES. Special properties such as ID, CATEGORY, ARCHIVE and EFFORT have meaning to Org. CUSTOM_ID gives a stable link target, and C-c C-x e sets EFFORT, an estimate for planning.

Archiving and logbook

Finished subtrees can be moved out of your way: C-c C-x C-a archives a subtree to a file named <file>_archive under a heading Archive. A :LOGBOOK: drawer collects state-change notes and clock entries when you turn on org-log-into-drawer. Keeping the notes in drawers hides them until you open the heading.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which key cycles a heading through TODO states?

    C-c C-t runs org-todo.
  2. 2. What does the | mean in #+TODO: TODO NEXT | DONE?

    States left of the bar are active; states to its right are finished.
  3. 3. Where do tags go on a heading?

    Tags are written at the end of the heading line between colons.
  4. 4. What is a progress cookie?

    [/] and [%] show a count or percentage that Org maintains for you.

Summary

  • C-c C-t sets a TODO state; define your own sequence with #+TODO: (states before | are active, after it finished).
  • Priorities ([#A]) and tags (:work:) classify tasks; tags are inherited by sub-headings.
  • Checkboxes plus [/] or [%] cookies track progress.
  • Property drawers (:PROPERTIES:) hold structured data that the agenda and column view can use.

Next: Org Agenda, Scheduling and Capture