parent: - "[[dev]]"

Collapsing Group Table

Bases Table & Card views that support collapsable grouping.

Two Bases Table and Card view for Obsidian that turns grouped results into a collapsible tree — fold and unfold groups like branches, optional support for nested hierarchical groups from a single /-delimited property, and edit your notes inline.

It adds new Bases and Card types that can be use in places of the Obsidian Bases Table and Card views with one that supports collapsable row groups based off GroupBy column set in the Bases configuration.

They also supports optional nested categories, for example: ”research/medical” or multiple columns and a number of new useful behaviors (example: accordion) . It tries to be a drop-in replacement for both the Obsidian Bases Table and Card views… tries to be (since Obsidian did not provide an extendible BaseTable object, several things had to be code from scratch, so somethings may vary). If you turn on nested groupBy keys, then it support up to multiple levels of nesting (example “art/painting/water_color” )

Requirements

• Obsidian (ver >= 1.10.2) — the Bases core plugin must be available.

Installation

Community plugin

Search for Collapsing Group Table in Settings → Community plugins → Browse.

BRAT (beta)

1. In Obsidian, install and enable BRAT (Settings → Community plugins → Browse).
2. Settings → BRAT → Add beta plugin.
3. Enter the repository ghyatt/bases-collapsing-group-table and click Add Plugin.
4. Enable Collapsing Group Table under Settings → Community plugins.

Usage

1. Create or open a Base.
2. Add a view and choose Collapsing group table or Collapsing group cards.
3. Set a Group by property in the Base's view options — this becomes the foldable branch.
4. Click a group header (or its chevron) to fold/unfold it.

If no Group by is set, the view renders as a plain table / card grid. Which rows appear, the column order, and the sort all come from the Base's own settings.

Collapsing & groups

• Click a group header — collapse or expand that group; closing a group also closes its sub-groups.
• Expand all / Collapse all — buttons in the control bar (which also shows Groups, Notes, the GroupBy columns, and a [nested] tag).
• Accordion mode — expanding one top group collapses the others (only one open at a time).
• Start with groups collapsed — open with everything folded.
• Group headers show an entry-count badge, and a sub-group count badge when a group has more than one sub-group.

Nested groups

There are two ways to nest, and they're mutually exclusive. Sub-group headers and the rows beneath them are joined with tree-command-style connectors (├──, └──, │).

Split group value on "/" — turn on the toggle and any group value containing / becomes a nested tree, to multiple levels. e.g. grouping by a category of ai/llm_wiki, ai/tools, obsidian/plugin:

▾ ai
  ├── ▾ ai → llm_wiki
  │   ├── bookBases.md
  │   └── books.md
  └── ▾ ai → tools
▾ obsidian
  └── ▾ obsidian → plugin

Sub-group by columns — instead of the / split, pick Sub-group by (2nd level) / (3rd level) properties to nest by those columns (values used whole, never split).

When opening a group controls what the sub-groups do on open (and on initial load): open the first sub-group, all of them, or none.

Inline editing (table view)

In the table view, click a cell backed by a note property to edit it; changes are written to the note's frontmatter.

• Checkbox — boolean properties render an editable checkbox.
• Text — opens a multi-line editor sized to the row height.
• Number / Date — single-line editors (date uses a date picker).
• Tags / link lists — items render as native tag pills / clickable links, each with a × to remove; click the cell to add more, with autocomplete of existing vault tags or pages.
• File name renders as a clickable link to the note.

Layout

• Row height — Short / Medium / Tall / Extra tall (1 / 3 / 6 / 12 lines) or Dynamic; image cells scale to match.
• Resizable columns — drag a column header's right edge; double-click it to auto-fit. Widths are shared with the built-in Table view (columnSize).
• Headers show a type icon, the column name, and the current sort direction arrow.
• Date format — optionally format date cells with moment tokens (e.g. YYYY-MM-DD).

Your fold state and column widths are saved into the .base file, so they survive reloads.

Cards view

The Collapsing group cards view renders entries as cards (cover image + title + fields) with the same collapsible grouping, nesting, and accordion behaviour. It reads the built-in Cards view's settings (image, cardSize, imageAspectRatio, imageFit), so an existing type: cards view can be switched over — or set them via the view options:

• Card image property — the property used as the cover.
• Card width — card size in px.
• Image fit — cover (crop to fill) or contain (whole image), paired with Image aspect ratio (height ÷ width; 0 = natural) for uniform covers.
• Filename — show below the cover, hide, or overlay on the cover (revealed on hover).

The cover and filename are clickable to open the note.

Configuration

All options are set from the Base view configuration menu, organized into sections.

Grouping & nesting (both views)

Table

Cards

License

MIT — provided as is. File bugs or feature requests on GitHub.

Bugs

• Please reports any issues at the GitHub issues for Obsidian Collapsable Table Base