Skip to content
Tutorials Center
My learning

Topics

Lesson 18 of 38 ยท Org Mode

Org Agenda, Scheduling and Capture

Plan with Org: timestamps, SCHEDULED and DEADLINE, repeaters, the weekly agenda and TODO lists, tag and property searches, org-agenda-files, and capture templates for quick notes.

The agenda is what turns an Org file from notes into a planner. It reads the dates, TODO states and tags across your files and builds a view of what to do today, this week or by topic. Capture is its counterpart: a way to add a note or task from anywhere in Emacs in a few keystrokes, without leaving what you are doing.

Timestamps

A timestamp is a date in angle brackets: <2026-11-13 Fri> or with a time <2026-11-13 Fri 14:30>. A timestamp in square brackets, [2026-11-13 Fri], is inactive: it records a date but does not show in the agenda.

Keys Effect
C-c . Insert an active timestamp (a calendar pops up)
C-c ! Insert an inactive timestamp
S-<left> / S-<right> On a timestamp, change the day by one
S-<up> / S-<down> Change the part under the cursor (day, month, year, hour)
C-c C-s org-schedule: set SCHEDULED for the heading
C-c C-d org-deadline: set DEADLINE

In the date prompt you can type natural input: +1w (next week), fri, +2d, 3pm, nov 20, or press RET for today.

Scheduled versus deadline

  • SCHEDULED: <2026-11-13 Fri> says when you plan to start the task. It appears on that day and stays on the agenda, flagged as late, if you leave it unfinished.
  • DEADLINE: <2026-11-20 Fri> says when it is due. The agenda warns you ahead of time, by default 14 days (org-deadline-warning-days), and shows how many days remain.
ORG
* TODO Submit the report
  DEADLINE: <2026-11-20 Fri> SCHEDULED: <2026-11-16 Mon>
* TODO Water the plants
  SCHEDULED: <2026-11-13 Fri +1w>

The +1w is a repeater: after you mark it DONE, Org moves the date a week ahead and resets the state to TODO. Variants are ++1w (next occurrence in the future) and .+1w (a week from the day you finish).

JS Stand-in: parse SCHEDULED and DEADLINE

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

No output.

Telling the agenda where to look

The agenda reads org-agenda-files. Add files from inside Org with C-c [ (and remove with C-c ]), or set the list in your init file:

ELISP
(setq org-agenda-files '("~/org/tasks.org" "~/org/projects.org"))
;; a directory works too: every .org file inside is used
(setq org-agenda-files '("~/org/"))

Open the agenda dispatcher with M-x org-agenda, which you bound to C-c a in the previous lesson. The main choices are:

Key View
a Weekly agenda (7 days from today, with scheduled and deadline items)
t Global list of all TODO items
T The same, filtered by a keyword
m Search by tags and properties (such as +work-urgent)
s Search for text in headings
< Restrict to the current file

Working in the agenda buffer

The agenda is read-only; each line acts as a link to the heading in the original file:

  • RET or TAB visits the entry; SPC shows it in another window.
  • t changes the TODO state; , sets the priority; : sets tags.
  • d, w, m and y switch to day, week, month or year view; f and b move forward and back; . goes to today.
  • r rebuilds the view; g refreshes it from disk; q quits.
  • C-c C-s and C-c C-d reschedule or set a deadline for the item under the cursor, and C-c C-x C-c runs column view.

org-agenda-start-on-weekday set to nil shows the next seven days starting today instead of a calendar week.

Capture: add items without opening the file

org-capture, bound to C-c c in the previous lesson, opens a small buffer with a template, lets you type, and files the result in the right place when you press C-c C-c. Cancel with C-c C-k. The templates are defined in org-capture-templates:

ELISP
(setq org-capture-templates
      '(("t" "Task" entry (file+headline "~/org/tasks.org" "Inbox")
         "* TODO %?\n  %U\n  %a")
        ("n" "Note" entry (file "~/org/notes.org")
         "* %?  :note:\n  %U")))

Each entry is: key, description, entry type, target and the template text. Useful escapes: %? is where the cursor ends up, %U a timestamp with the time, %t the date, %a a link to where you were when you started the capture, %i the selected text. Capture with C-c c t creates a task from anywhere, for instance while reading code, and the %a link takes you back later. A related command is org-refile (C-c C-w), which moves a heading to another heading or file; configure targets with org-refile-targets.

JS Stand-in: expand a capture template

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

No output.

A small, workable system

You need very little to begin: one inbox.org file where everything is captured, one tasks.org for projects, and the weekly agenda. Capture all new tasks to the inbox, refile them during a daily or weekly review, set SCHEDULED for what you will do and DEADLINE for what is really due. Keep tags for contexts. More advanced features, such as custom agenda commands, clocking time (C-c C-x C-i / C-c C-x C-o) and habits, can wait until this basic loop works for you.

Check your understanding

Quick check ยท 5 questions

of 5 answered You scored / 5 ยท perfect!

  1. 1. What is the difference between SCHEDULED and DEADLINE?

    A scheduled item shows on its day; a deadline warns you ahead of time.
  2. 2. Which key sets a DEADLINE on the current heading?

    C-c C-d is org-deadline; C-c C-s is org-schedule.
  3. 3. What does +1w after a date mean?

    A repeater moves the date forward when you mark the task DONE.
  4. 4. In a capture template, what does %a insert?

    %a is an annotation (link) to the current location; %i is the selected text.
  5. 5. How do you tell Org which files the agenda should read?

    org-agenda-files is the list of files or directories the agenda scans.

Summary

  • Active timestamps <...> appear in the agenda; C-c C-s sets SCHEDULED, C-c C-d sets DEADLINE, repeaters like +1w recur.
  • Set org-agenda-files, then use C-c a (after you bind it) for the weekly agenda, TODO lists and tag searches.
  • In the agenda, t, RET, d/w/m, f/b and . let you act and navigate.
  • org-capture templates add tasks and notes from anywhere; org-refile moves them later.

Next: Org Tables, Code Blocks and Export