# Views A view shows a set of entities or blocks a particular way. The same set can be a table, a board, a calendar or a chart. A tag's page, a [query](queries.md) and a page's own blocks can each be shown in a view. Changing a view changes how they look, never what they are. ![The #task tag page on its All tasks side: Table and Add a view, the icons for Filter, Sort, Search and View settings beside New, and a table of tasks with Status, Due and Project columns](img/view-table.webp) *A tag's page, in Table view.* ## The views | View | Shows | | --- | --- | | **Table** | One row each, a column per field. | | **Board** | Cards in columns by a field. Drag a card to another column to change that field. | | **List** | One row each, with the fields its blocks show. | | **Outline** | Each one as a block, with the blocks inside it and bullets on every block. | | **Prose** | Each one as a block, without bullets. | | **Numbered list** | Each one as a numbered block. | | **Checklist** | Each one as a block with a box to tick. | | **Calendar** | Each one on its date, by month, week or day. | | **Gallery** | A card for each, with a picture or its first blocks. | | **Chart** | A bar, line or donut chart of them, or one number. | | **Canvas** | A card for each, placed where you put it. See [Canvas](canvas.md). | ## Where views live - **A tag's page**: its **All** side lists every entity with that tag, wherever it shows. It starts with one Table. *Add a view* adds another, with its own filters, sort and fields. With many views, their tabs become icons. - **A query** holds one view. Click the icon beside its count, then *Layout*, to change it. For another look at the same results, pick *Duplicate the query* and change the copy. See [A query's view](queries.md#view). - **A page's blocks**: in the page's **⋯** menu, **View as** shows them as Default, Outline, Prose, Numbered, Checklist, Canvas, List, Table, Board, Calendar, Gallery or Chart. **Add a view** adds another, with the same choices, and the views show as tabs with the same buttons as a tag's page. - **Any block's children**: right-click its bullet and pick **View as**: Default, Outline, Prose, Numbered, Checklist, List, Table, Board, Calendar, Gallery or Chart. A view that needs a field asks for one in place. A Board with no Select field offers to add a Status field (To do, Doing, Done) to those blocks with one press. A tag with no Date field can still have a Calendar, and asks for one. Your views and their settings are kept in the notebook, so they reach your other devices when sync is on. ### A tag's view tabs Right-click a view's tab for *Rename*, *Move left*, *Move right* and *Remove this view*. Double-click a name to rename it. In **View settings**, *Duplicate view* makes a copy and *Delete view* removes it. ## The buttons above a view At the right of the view's tabs are four icons and **New**. Rest the mouse on an icon for its name. A Chart and a Canvas have fewer: their other settings are in View settings. - **Filter**: see [Filter](#filter). - **Sort**: see [Sort](#sort). - **Search**: finds words in this view's entities. - **View settings**: the view's own settings, listed below. At the top is the view's name, then **Layout**, which shows the layout it has, such as “Layout: Table”. Click it for every layout, and pick one to change it. - **New**, and *+ New #name* under a view, make a new entity with the tag. It stands on its own, on no page: it is in the tag's views, search, ⌘K and the Library until you show it on a page or mention it. Type its name, then press `Enter` to add it, or `⇧Enter` to add it and start the next one. ## Filter Click **Filter** and pick a field. The filter shows above the view as a chip, with its rule and value. Click the chip to change it, or *Remove* to take it off. With a filter on, the view says how many it shows, as “4 of 12”. A row you change so it no longer passes, such as a task you tick in a view of open tasks, leaves the view at once. A row you just made with **New** stays, even when it doesn't pass yet. On a computer, once a tag page's view has filters, **Filter** hides and shows their row of chips. Its dot says filters are on, and *+ Filter* is in the row. The view keeps the row hidden or shown. On a phone, **Filter** adds one. The rules depend on the field's Type: - **A Select**: *is*, *is not*, *is empty*, *is not empty*. Pick one option or several. - **A Date**: *is*, *is before*, *is on or before*, *is after*, *is on or after*, *in the last*, *in the next*, *is empty*, *is not empty*, and this, last and next week, month and year. - **A Checkbox**: *is checked*, *is not checked*. A filter names a field by its own name, such as `Paid = true`. The rules are the same as in [Queries](queries.md#rules). ## Sort Pick a field under *Sort by*, then more under *Then by*, each Up or Down. *Clear* goes back to newest edited first. In a table, click a heading to sort by it: up, down, then off. ## Fields that every entity has Filter, Sort and a view's Fields also offer what Fennick keeps on every entity: *Mentions* (every page it is on or named in), *Edited*, *Edited by*, *Created*, *Created by*, *Blocks under it*, *Progress*, *Word count*, *Characters*, *Files*, *Edits*, *Completed on*, *Status changed on* and *Tags*. ## Table Type names and numbers in place. Click a choice, date or other value to change it in the same small menu as the fields box. A wide table scrolls sideways in its own box. Drag a column's edge to resize it (double-click to fit), and drag a heading to move the column. **+** at the end of the headings adds a field. In **View settings**: - **Fields**: switch each column on or off, or *Hide all* and *Show all*. *More system fields* has the rest. - **Group**: *Group by* a Select, a Date, a Checkbox, a Select from tag field, *Edited by* or *Mentions*. A date groups by Day, Week or Month. Each group folds, and has its own *New*. *Hide empty groups* does what it says. ## Board Cards in columns. Drag a card to another column to change that field. ![A Board of tasks by Status: columns No Status, To do, Doing and Finished, each with its count and a New task button, and Add group at the end](img/view-board.webp) *A Board, grouped by Status.* - **Group** in View settings: *Group by* picks the field for the columns. *Lanes* adds rows by a second field. *Columns* lists the groups. *Hide empty groups* leaves out a column or lane with nothing in it, as in a table. - Grouped by a Select from tag field, each entity it can point at is a column. A card sits in its entity's column, dragging it sets that entity, and *New* in a column links the new one. - **Add group**, after the last column, adds an option to the field. - A card with several values, in a Multi-select, shows in each of their columns. Dragging it from one column to another swaps only that value. - **Fields** picks what the cards show, including *Cover picture*. ## Pick several Point at a row and click the box in the margin beside it to pick it; pick as many as you like. A bar shows how many are picked, with: - The field the view is grouped by, or else the first Select field. Pick a value and every picked row gets it, in one step of Undo. - **Move**, **Tag**, **Merge** and **Move to Trash**. - **⋯**: *Set*, *Duplicate* and *Select all*, and *Done* when every picked row can be done. - **×** lets go of them. ## List One row each, showing the fields that a block with the tag shows in your writing, in the same form. In View settings: **Fields** (turn each on or off for this List), **Show covers**, **Show page preview**, **Density** (Auto, Compact or Roomy) and **Group**. Compact puts a row's fields at its name's right. Roomy puts the fields under the name. Auto is Compact on a computer and Roomy on a phone. Show page preview is off at first. Turn it on to see the first words written on each page, in grey, cut short at the row's end: under the name in Roomy, under the name and fields in Compact. A page with no words shows none. A row that shows two dates puts each one's name before it, such as “Edited Sat” and “Created Thu”. Every List looks the same: on a tag's page, in a query, in the Library, in Tasks, and for the blocks under a block. Rows sit in no box, with a hairline between them. A row that can be done shows its box in place of the colored dot. On a computer, click a row's name to rename it right there. Click anywhere else on the row, or press `⌘Enter` in the name, to open it. On a phone, tap a row to open it; to rename it, hold the row and pick **Rename** under **⋯**. ## Outline, Prose, Numbered list and Checklist Each entity is the real block, with the blocks inside it, so you can read and edit them where they are. They have Filter and Sort. ## Calendar A month, with ← and → for the month before or after and **Today** to come back. The week starts on the day set in [Settings](settings.md#appearance). Each entity shows on its date, in its own tag's color, as its bullet is in a List: a #announcement that builds on #task is in #announcement's color on the #task page. With two tags, it takes the first's color; with a tag that has no color, its card is plain. In a month, a day shows three, and “+2 more” says how many others there are. ![A Calendar view of tasks for one month, with a No date button above it](img/view-calendar.webp) *A Calendar view.* In **View settings**: - **Show by**: which Date field to use. - **Show as**: Month, Week or Day. - **Fields**: what each entry shows. On a computer, a Week and a Day show the day's 24 hours under the days. An entity whose date has a time sits at its hour: an hour tall, or as long as its end time says, beside any others at the same time. One with no time, or a range over several days, sits above the hours, in its day's row. The hours open just above the first time shown (with no times, at the morning), and a mark across them shows the time now. Click an empty hour to make a new one at that hour. Drag one with a time to another hour, or another day, and it moves to the quarter hour under the mouse; its end moves with it, so it lasts as long as before. `Esc` while dragging puts it back. Drag one with no time to another day, or into an hour to give it that time, to the quarter hour. A range over several days stays a bar above the hours. An entity dated a whole week sits in a ribbon along the top of its week, named by its number, such as “Week 46”, in the color of the `#week` tag. With [Week numbers](settings.md#appearance) on, every week has its ribbon. An entity dated a whole month sits in a row above the calendar, under the month’s name. - **Click an entry** to open a page it shows on, with the entry lit. On a computer, rest the mouse on it for the [peek](links.md#peek), and edit it there. - **Click a day** to open its day page. - **+ on a day**: point at a day and click its **+** (on a phone the + is always there). A new #name is made, dated that day. Type its name; `Enter` adds it, and `⇧Enter` adds it and makes another on the same day. - **Drag an entry's edge** to make it a range of days. - **New** and *+ New #name* under the calendar make one with no date. Its name is typed in the **No date** panel. When the tag has a Date field, **No date (5)** above the view says how many have no date, through the view's filters. Click it for the panel: search them by name; click one and then a day to date it, or drag it onto a day; **Open** on a row opens it. `Esc`, or a click outside the panel, closes it. The **Calendar** page in the command menu is the same month for the whole notebook: every dated entity of every tag, and how many blocks each day page has. ### On a phone A Calendar on a phone is a week strip over a list of days. The day you picked is filled in, and today is in color. Set to Day, it shows that day's hours under the strip, as on a computer; set to Month, it opens with the month pulled down. - Tap a day in the strip to go to it in the list. - Scroll the strip sideways: it moves under your finger and comes to rest on a whole week, and the list follows. Scroll the list, and the strip follows it to the day at the top. - Pull the strip down by its grab bar, or tap the month's name, for the whole month. It scrolls up and down without end, and the list follows it the same way. Push it back up to fold it. - **No date 5 ›** is a row at the top. - Each day has a heading with its own **+**, and its entities under it with their whole names. An entity over a range of days says which day each one is, such as “2 of 3”. One with a time says it at the right, and they are in time order. - A month's entities have a section of their own, such as “November · the whole month”, and so do a week's, such as “Week 46 · Nov 9 – 15”. - A Calendar that is the page lists every day from today, or from an earlier day you pick, an empty one in grey. Among a page's other blocks, it lists only the days with something on them. - As you scroll, the strip stays at the top, and each day's heading stays under it until that day's entities have gone by. ## Gallery A card for each entity, in its own tag's color, as on a Calendar. Click a card to open it. A new card is named in place. In **View settings**: - **Card preview**: Page cover and content, Page cover, Entity picture, First picture in page, or None. - **Card size**: Small, Medium or Large. - **Fields**: which fields the cards show. A card leaves out a field with no value. - **Group**, as in a table. ## Chart A chart of the entities that pass the view's filters. Its settings are in **View settings**: - **Show as**: *Bar*; *Bars across*, a row each with its whole name and its value at the end; *Line*; *Donut*, with the total in the middle; or *Number*, one large figure under what it shows, such as “Sum of Hours”. - **By**: the field to group them by: a Select, a Date (then Day, Week or Month), a Checkbox, a Select from tag field, *Edited by* or *Mentions*. - **Shows**: *Count*, or *Sum of* or *Average of* each Number field. - **Split by**: stacks each bar by a second field. - **Order**: *Field order* or *Largest first*. - **Hide empty groups**: leaves out a group with nothing in it. It is off at first, and isn’t offered when By is a Date, where an empty week stays 0. Bars and the donut’s parts wear each option's color; a line wears the tag's. With nothing to show, it says “Nothing to chart yet.” ## Canvas A card for each, placed where you put it. See [Canvas](canvas.md).