Special Properties (The Org Manual)

Next: Property Searches, Previous: Property Syntax, Up: Properties and Columns [Contents][Index]

7.2 Special Properties

Special properties provide an alternative access method to Org mode features, like the TODO state or the priority of an entry, discussed in the previous chapters. This interface exists so that you can include these states in a column view (see Column View), or to use them in queries. The following property names are special and should not be used as keys in the properties drawer:

‘ALLTAGS’ All tags, including inherited ones.

‘BLOCKED’ t if task is currently blocked by children or siblings.

‘CATEGORY’ The category of an entry.

‘CLOCKSUM’ The sum of CLOCK intervals in the subtree. org-clock-sum

must be run first to compute the values in the current buffer.

‘CLOCKSUM_T’ The sum of CLOCK intervals in the subtree for today.

org-clock-sum-today must be run first to compute the

values in the current buffer.

‘CLOSED’ When was this entry closed?

‘DEADLINE’ The deadline timestamp.

‘FILE’ The filename the entry is located in.

‘ITEM’ The headline of the entry.

‘PRIORITY’ The priority of the entry, a string with a single letter.

‘SCHEDULED’ The scheduling timestamp.

‘TAGS’ The tags defined directly in the headline.

‘TIMESTAMP’ The first active keyword-less timestamp in the entry.⁵³

‘TIMESTAMP_IA’ The first inactive keyword-less timestamp in the entry.

‘TODO’ The TODO keyword of the entry.

Footnotes

(53)

For both ‘TIMESTAMP’ and ‘TIMESTAMP_IA’: the word “first” refers to the first occurrence in the entry, not the earliest in time; the prefix ‘CLOCK:’ at the beginning of a clock entry is considered a keyword in this context; and timestamps inside property drawers are ignored.

Next: Property Searches, Previous: Property Syntax, Up: Properties and Columns [Contents][Index]