---
title: "Document feed"
description: "The document stream of a space: list or grid, grouping by date, and facets."
---

# Document feed

The Feed is your personal stream of a space's documents: every note in a single chronological view that you reshape for the task at hand with toggles and facets. The Feed is the default view of the combined **Files** section — it has no icon of its own on the rail; it opens from the Files icon (see [Navigation and tree](/docs/guides/navigation/)).

## View and grouping

The Feed header carries four controls — **Group · Sort · Size · View**:

- **View** — **list** or **grid**. The list draws a timeline: date and thumbnail on the left, title, tags, and snippet on the right. The grid lays out card tiles.
- **Size** — density. In the grid this is the number of columns: `1` (large cards with a banner), `3` (a dense structured grid, the default), `5` (compact square posters). The same switch sets the snippet length.
- **Group** — grouping by date: off, by day, by week, or by month. Section headers are known in advance, so scrolling never "jumps."
- **Sort** — sort by date **created** or **modified**.

On a narrow screen both views collapse into a single column of cards, and the Size and View switches are hidden.

## Facets

The Feed sidebar is a set of filters. They all stack (folder ∧ tag ∧ text ∧ date) and speak the same language — inclusion (nothing selected = no filter = everything shown):

| Facet | How it works |
|---|---|
| **Folders** | Clicking a folder adds its whole subtree to the focus; several folders combine. "Show only this folder" leaves just that one. |
| **Tags** | Hierarchical chips with search; selecting several tags shows notes that have any of them (a union). More in [Tags](/docs/guides/tags/). |
| **Text** | A full-text query from the search field in the top bar narrows the Feed down to matches (lexical search). |
| **Dates** | A "from / to" range on the active sort axis (created or modified). |

The active filter reads straight off the panel (filled-in labels and a Clear button) — nothing floats on top of the Feed.

## Scale

The Feed is built for **tens of thousands of entries**. The server delivers data in windows: it computes the exact total, the sort, and the slice, while the client keeps a sparse cache of pages — the full list never travels across the network in one piece. Every view is virtualized, so jumping to an arbitrary scroll position loads exactly the window you need.

> [!note] A filter, not a ranking
> A text query in the Feed **narrows** the list but does not change its order — the sort stays by date. For ranked search with relevance, go to [Search and Spotlight](/docs/guides/search-spotlight/).