Skip to main content
3 of 3
added 310 characters in body
NickD
  • 33.6k
  • 3
  • 30
  • 47

You can have Org files anywhere in your filesystem, but only the files appearing in org-agenda-files contribute to the agenda. Do C-h v org-agenda-files to read about this variable and how to set it and read the Agenda files section in the manual for more information.

One common way to do that is to put all of the agenda-contributing files (and only those) in one directory and then set org-agenda-files appropriately to pick them up by adding this to your init file (change the path according to your circumstances):

(setq org-agenda-files '("/path/to/agenda/files/folder"))

Then every file in the named directory whose name matches a regular expression is added to the agenda files list/. By default, the regular expression matches files with a .org suffix, so if you name your Org mode files that way, you don't need to worry about it.

In addition, in order to appear in the agenda, an item has to have a timestamp (actually, an active timestamp - items with inactive timestamps are not shown in the agenda). Only items whose timestamps fall within the time span of the agenda are shown.

Here is an example file:

* a plain, active timestamp
  <2022-10-05>

* a plain, inactive timestamp
  [2022-10-05]

* a scheduled item
  SCHEDULED: <2022-10-06>

* a deadline item
  DEADLINE: <2022-10-05 Wed>

You can temporarily add the file to your agenda with C-c [ and then do C-c a a to show the weekly agenda (assuming you have followed the conventional wisdom in the manual, binding C-c a to org-agenda and that you have not changed the default weekly time span). All of the above items will show in the agenda, except for the inactive timestamp one. But if you do C-c a next week, none of them will show since their timestamps will not intersect the time span of the future agenda.

You can remove the file from org-agenda-files with C-c ]. C-c [ and C-c ] are useful for testing, so that you can temporarily add a file the org-agenda-files list and then remove it, but in order to add a file to org-agenda-files permanently, you must initialize the variable properly in your init file.


These are very basic questions that could be best answered by working diligently through an Org mode tutorial, e.g. this one or this one. Also the Org mode Wiki has a Tutorials section with more in-depth coverage.

NickD
  • 33.6k
  • 3
  • 30
  • 47