# Table columns

Columns are how a table decides which fields each row shows and how each one looks. A column can be any [task field](/docs/docs-018-task-properties/), from status and due date to your own custom keys, and each column carries its own width, alignment, color, and format. Columns belong to the [preset](/docs/docs-109-table-presets/), so every table can show a different set of fields arranged its own way. This page covers what a column can hold and every way to shape one.

> **MEDIA-DOCS-106-1:** A table with several columns: task, status, priority, due date, estimate, and source.

![MEDIA-DOCS-106-1 - A table with task, status, priority, due date, estimate, and source columns](/assets/docs/media/MEDIA-DOCS-106-1.png?v=6f6f200fcad4)

## Which fields can be a column

Almost any field a task carries can become a column:

- **Task fields**: the description (shown as **Task**), status, priority, Task Type, Task Image, Task Gallery, the dates (due, scheduled, start, and the completion and cancellation dates), estimate, duration and its rolled-up totals, assignees, contexts, parent, blocking and blocked-by links, location, recurrence, tags, and note.
- **Your custom keys**: any [custom key](/docs/docs-040-custom-keys/) appears as a field you can add as a column, so a table can carry exactly the properties your workflow uses.
- **File task properties**: frontmatter properties Operon does not manage, found automatically on the file tasks in the preset's current scope, typed and offered as columns with no setup at all. See [File task property columns](/docs/docs-115-file-task-property-columns/).
- **Source and file fields**: read-only columns that describe where the task lives, such as **Source**, source path, source line, and the file name, basename, path, and folder.
- **Identity**: the task's [operonId](/docs/docs-015-task-identity-and-operonid/), as a read-only column, and its [Project Serial](/docs/docs-097-project-serials/) where a scope is set up, also read-only.
- **Countdown**: a read-only calculated column showing time remaining until a Scheduled or Due target, without adding a task property.
- **Task Tree**: a read-only presentation column that can expand the parent and subtask hierarchy around a row without writing a task field.

You add a column from a header's menu with **Add column to left...** or **Add column to right...**, or from the preset's **Columns** section. See [Table presets](/docs/docs-109-table-presets/).

**Pipeline is the derived-field exception.** It never appears in the column picker, because it is not a column at all, only a field you can group, subgroup, or sort by. See [Table grouping and sorting](/docs/docs-107-table-grouping-and-sorting/).

## Task Tree: hierarchy without changing the result

Add **Task Tree** when you want to inspect parent and subtask structure beside the normal Table fields. It starts as a compact, centered, read-only column. A parent occurrence gets an expand or collapse control; detailed mode also shows hierarchy numbers such as `1`, `1.2`, and `1.2.1`.

Expanding a row projects its descendants directly beneath that occurrence, including descendants that the preset's filter did not return on their own. A matching child can therefore appear twice: once as its normal base row and once as context inside an expanded parent branch. Each visible occurrence expands independently, and the expansion state is saved with the preset.

Task Tree never rewrites `parentTask`, moves the base rows, or changes Table counts, summaries, grouping, or export. Existing sort rules can still order siblings inside a projected branch, but Task Tree cannot itself be used as a group, sort, or summary field. It can be aligned, colored, resized, and switched between compact and detailed display like a presentation column. See [Parent and sub-tasks](/docs/docs-016-parent-and-sub-tasks/) and [Table grouping and sorting](/docs/docs-107-table-grouping-and-sorting/).

## Countdown: time until a task date

Add **Countdown** from the column picker when you want remaining time beside your tasks. It starts in **Compact** mode with **Center** alignment and **Earlier date** as its target. It is not added to existing tables automatically. The column works in both Table views and embedded tables, using the tasks already included by the preset; it does not apply the Upcoming Tasks day window or hide terminal tasks on its own.

Right-click the **Countdown column header**. Immediately below **Add column to right...**, a separate section shows three choices directly:

| Target | Counts toward |
|---|---|
| Earlier date (default) | The earlier of the valid Scheduled and Due candidates |
| Scheduled | A valid scheduled start date and time, otherwise the Scheduled date |
| Due | The Due date, with day precision |

Earlier date compares calendar dates first. On the same day, a timed Scheduled candidate takes precedence over an all-day Due candidate. Two all-day candidates on the same date share the tooltip heading **Scheduled / Due**. If only one candidate is valid, Earlier date uses that one. Actual started dates and end times are not targets.

A past target stays at zero; Earlier date does not skip it to count toward the later date. Changing the source dates or the selected target recalculates the result. With no valid target, the cell is fully empty in both modes.

Target selection is saved with the column in the preset. For borders, alignment, units, and the live tooltip, see [Table cells: display and behavior](/docs/docs-112-table-cells-display-and-behavior/). Countdown is read-only: clicking or double-clicking its cell does not open an editor or start tracking. It supports sorting by the selected target date, but not grouping, summaries, or a dedicated countdown filter.

## File task properties, without setting anything up

The column picker groups discovered frontmatter properties under **File task properties**, separate from your custom keys. You never define these: write a property in a file task's frontmatter, and if that task is in the preset's current scope, the property appears here already typed as Text, Number, Date, Date & time, List, or Checkbox, read from Obsidian's own Properties view or inferred from your data. Editing one opens the same picker its type would use for a custom key, and a Checkbox column gets its own toggle chip right in the cell. This is deliberately lighter than a Custom Key: no name, type, icon, or surface choice to make first. See [File task property columns](/docs/docs-115-file-task-property-columns/) for the full picture, including why it differs from Custom Keys and Key mappings, and exactly where it does and does not reach.

## Shape a column from its header

Right-click, or open the menu on, a column header to reach everything you can do to that column:

| Action | What it does |
|---|---|
| Rename column... | Gives the column a custom display name for this preset |
| Align left / Align center / Align right | Sets alignment; for Countdown, moves the border while its detailed value stays right-aligned inside |
| Pin column / Unpin column | Freezes the column so it stays in view as you scroll sideways |
| Show total / Show sessions | For the duration column only, switches what it counts (see below) |
| Show compact cell / Show detailed cell | For icon-bearing task fields, collapses the cell to its compact icon view, or restores the full value |
| Add column to left... / Add column to right... | Inserts another field beside this one |
| Earlier date / Scheduled / Due | For Countdown only, selects the date to count toward |
| No color / Task color / Priority color / Status color / Random colors | Chooses how the cells are tinted (see below) |
| Summarize column... / Edit summary... | Adds or edits a summary at the foot of the column. See [Table summaries](/docs/docs-108-table-summaries/) |
| Edit preset | Opens the full preset settings. See [Table presets](/docs/docs-109-table-presets/) |
| Hide column | Removes the column from the table |

You cannot hide the last remaining task column, so a table always shows at least one field.

**Rename column...** opens a small popover to give the column a custom name, shown in its header instead of the field's normal label. It only relabels the column in this preset; the underlying task property is untouched, so a renamed **Due** column still edits and sorts the task's actual due date. For most compact fields, the hover tooltip shows the custom name too. Countdown keeps its source heading—Scheduled, Due, or Scheduled / Due—so the date being counted toward remains clear.

## Resize and reorder by dragging

Two things you do directly on the header rather than through the menu:

- **Resize**: drag the edge of a header to set the column's width. Widths are remembered per preset.
- **Reorder**: drag a header onto another to move the column there. For more deliberate layout changes, open **Edit preset** and use the preset's **Columns** section.
- **Sort**: click a header, or focus it and press **Enter** or **Space**, to cycle the primary sort for that column.

> [!tip] Switch compact and detailed cells quickly
> On desktop, double-click the same column header edge you drag for resizing. This switches a supported task-field column between compact and detailed cell mode. It is the quick shortcut for **Show compact cell** and **Show detailed cell**, so you do not need to open the header menu.

> **MEDIA-DOCS-106-2:** A column header menu open, showing alignment, pin, color, summary, and column options.

![MEDIA-DOCS-106-2 - A table column header menu](/assets/docs/media/MEDIA-DOCS-106-2.png?v=1385403dabe0)

## Column color

A column can tint its cells so a value reads at a glance. For columns that support color, the header menu offers these color modes directly:

| Mode | Cells are colored by |
|---|---|
| No color | Nothing; plain text |
| Task color | The task's own color |
| Priority color | The task's priority color |
| Status color | The task's status color |
| Random colors | A stable color per distinct value in the column |

Sensible defaults apply without any setup: a **status** column uses status color, a **priority** column uses priority color, and a task-color column uses the task color. **Random colors** is useful on a grouping field such as assignee or context, where each distinct value gets its own consistent tint. The description, source, and duration columns do not take a color.

For **Countdown**, Random colors uses the selected target’s calendar date rather than the changing remaining-time text. Minute or second updates therefore do not change its color; changing the target date can. Its border and hover/focus accent follow the existing Table chip styling.

## Duration: sessions or total

The **duration** column can show two different things, switched from its header:

- **Show sessions**: the time tracked directly on that task.
- **Show total**: the task's duration rolled up with its sub-tasks.

The estimate and duration columns also have their own rolled-up total fields you can add as separate columns. See [Time tracking](/docs/docs-034-time-tracking/).

## Compact cell columns

Icon-bearing task-field columns can be collapsed with **Show compact cell**, which drops the full text and keeps the compact icon view, a tidy way to keep a status, priority, or type column narrow. **Show detailed cell** restores the full value. Description and note can also use compact cell mode when available; those compact text cells open the text editor popover instead of a normal field picker. This is the column-level counterpart of the Icon Only setting on [task chips](/docs/docs-041-task-chips-display-and-behavior/). For exactly what a cell shows and does in each mode, including the hover tooltip that keeps a compact cell readable, see [Table cells: display and behavior](/docs/docs-112-table-cells-display-and-behavior/).

## Editable and read-only columns

Most columns are editable: click a cell to change that field on the spot, as covered in [Table overview](/docs/docs-105-table-overview/). Some columns are read-only by nature and only display their value:

- **Editable task fields** include status, priority, Task Type, Task Image, Task Gallery, description, note, due, scheduled, start, completion and cancellation dates, repeat end, estimate, recurrence, parent and dependency links, tags, contexts, assignees, location, the task icon field, task color, and supported custom date, datetime, number, text, and list fields.
- **File task property columns** are editable the same way, using the same pickers, but only while their value actually matches the column's type; a value that does not drops to read-only until you fix it in Obsidian's Properties view. See [File task property columns](/docs/docs-115-file-task-property-columns/).
- **Countdown** is calculated from task dates and has no writable value.
- **Source and file columns**, which describe where the task is stored rather than a property you set.
- **Identity, checkbox, progress, Task Tree, and helper columns**, such as operonId, Project Serial, checkbox, subtask progress, line number, task icon helper, and Task Data Type helper columns, are read-only or have their own dedicated action instead of opening a normal field picker.

The source column is still active: clicking it opens the task's source in a new tab.

## The three helper columns

Beyond your field columns, a table can show three fixed helper columns, turned on for every table in **Settings → Operon → Views → Tables**:

| Column | Shows |
|---|---|
| Line numbers | A row-number column at the start of the table |
| Task icon helper | A task icon that follows the global click preference, with the task’s context menu; see [State Icons](/docs/docs-099-state-icons/) |
| Task Data Type helper | An inline-or-file icon that opens the [Task Editor](/docs/docs-021-task-editor/); Cmd/Ctrl-click opens the task's source |

> [!tip] Jump from Task Data Type to source
> On desktop, click the Task Data Type icon to open the Task Editor. Cmd-click on macOS, or Ctrl-click on Windows and Linux, opens the task's source instead: the note for a File Task, or the exact line for an inline task. The editable Task Type field is a separate user classification.

These are global toggles rather than per-preset columns, so they appear the same way on every table. They cannot be reordered or hidden from a header menu.

## Tips

> [!tip] Let a narrow, ordered set of columns do the reading
> A table is easiest to scan when each column earns its place. Put the field you sort or group by near the description, collapse status and priority to icons, and pin the columns you always want in view. A focused six-column table tells you more at a glance than a wide one you have to scroll.

## FAQ

**How do I add a column?** Use **Add column to left...** or **Add column to right...** from a header menu, or the **Columns** section of the preset settings.

**Can I give a column a different label?** Yes. Use **Rename column...** from its header menu. It only changes the label shown in this preset; the column still reads and edits the same task field.

**How do I remove a column?** Choose **Hide column** from its header. A table always keeps at least one task column.

**Why can I not color a column?** The description, source, and duration columns do not take a color. Every other task field column can.

**Do column changes affect other tables?** No. Columns, widths, order, and color are stored in the preset, so each table keeps its own layout.

**Why did a frontmatter property show up as a column on its own?** It is an unmanaged file task property, discovered automatically from the tasks in the preset's current scope. See [File task property columns](/docs/docs-115-file-task-property-columns/).

**What is the difference between Task Type and Task Data Type?** Task Type is an editable Text property you control. Task Data Type is the read-only inline-or-file helper; it opens the Task Editor and Cmd/Ctrl-clicks through to the source. Its internal key `__taskDataType` is not writable task data.

**Why can the same task appear twice after I expand Task Tree?** Its normal row still belongs to the filtered Table result, while the second occurrence supplies hierarchy context under an expanded parent. Only the base row contributes to counts, summaries, grouping, and export; the current sort rules can still order siblings in the projected branch.

## Settings

The three helper columns are toggled in **Settings → Operon → Views → Tables**: show line numbers, show task icon helper, and show Task Data Type helper. Every other column choice, its field, width, order, alignment, color, and format, lives in the preset and is edited from the table. See [Table presets](/docs/docs-109-table-presets/).

## Related

- [Operon Docs MOC](/docs/docs-001-operon-docs-moc/)
- [Table overview](/docs/docs-105-table-overview/)
- [Gantt view](/docs/docs-139-gantt-view/)
- [Table cells: display and behavior](/docs/docs-112-table-cells-display-and-behavior/)
- [Table grouping and sorting](/docs/docs-107-table-grouping-and-sorting/)
- [Table summaries](/docs/docs-108-table-summaries/)
- [Table presets](/docs/docs-109-table-presets/)
- [Task images and galleries](/docs/docs-138-task-images-and-galleries/)
- [Custom keys](/docs/docs-040-custom-keys/)
- [File task property columns](/docs/docs-115-file-task-property-columns/)
- [Project serials](/docs/docs-097-project-serials/)