Hubs and tabs
A tab shows one thing: a view or an entry. Tabs sit in a tab bar. A hub is a tab bar of its own, in the sidebar.
Two kinds of tabs
The app has two kinds of tabs. They work in different places.
| Tabs | Where they sit | What one tab is | Example |
|---|---|---|---|
| Window tabs | in the window’s top bar, as in a web browser or the Notion desktop app | one page you have open, with its own back and forward | the tabs Running plan and Workouts |
| A page’s tabs | in the tab bar under the title of a collection, a global collection or a hub | one view or one entry, saved with that page | Workouts: All · Calendar · Stats ↗ |
- A window tab comes and goes as you work. Closing it never changes the page.
- A page’s tabs are part of the page. They stay until you remove them.
- + in the top bar (or
Ctrl+T) opens a new window tab on the Home hub, with search open. What you pick opens in that tab.
The rest of this page is about a page’s tabs. Window tabs, their menu and their keys are in Find your way around.
What a tab shows
| A tab shows | What you see in it | Example |
|---|---|---|
| A view of a collection | its entries, as a table, a board, a calendar or another view type | Workouts, as a calendar |
| A view of a global collection | the same, across several collections. Menus call it a global view. | Health log, as a feed |
| An entry | one property of the entry, or its whole entry page. You pick this with Show (below). | the “Fitness” dashboard, showing its Dashboard property |
An entry tab: pick the entry, then Show
A dashboard is an entry, so a dashboard tab is a normal entry tab. Every entry tab has two choices:
- The entry. Example: the “Fitness” dashboard.
- Show: what part of the entry the tab shows.
| Show | What you see | Example |
|---|---|---|
| One property | only that property, drawn the way it looks on the entry page, at full width | “Fitness”, property Grid: only its charts |
| The whole entry page | the entry page: its title, its properties, its Block pages and its Dashboards | the note “Running plan” |
- One property is the real property, not a picture. In the “Fitness” tab you drag and resize the tiles right there, as on its entry page.
- Example: the diary day “28 Oct”, property Liked today, shows only that text. A run, property Route, shows only the map.
What a tab shows at first
Each collection sets what its entries show in a new tab. We set these defaults:
| Collection | A new tab shows |
|---|---|
| Dashboards | its Dashboard property |
| Notes | the whole note (its entry page) |
| Every other collection | the whole entry page |
You change the default in the collection’s settings. See How its entries show. You change it for one tab in the tab’s menu.
The menu of an entry tab
Edit layout (a dashboard's own menu comes first)Add widgetBoard settings…─────────────Show ▸ ● Dashboard ○ Whole entry pageOpen dashboardRename tab- Show lists the entry’s properties and Whole entry page. Pick one, and the tab changes at once.
- Open dashboard opens the entry’s own entry page. The word comes from what one entry is called in its collection: Open note for a note, Open workout for a workout. See What one entry is called.
- Renaming a tab renames only the tab. Rename the “Fitness” tab to “Gym”, and the dashboard is still called “Fitness”. See Icon and name.
One tab bar everywhere
The tab bar is one component. It works the same everywhere, with the same options. Three things have a tab bar:
| Tab bar of | Its tabs | Example |
|---|---|---|
| A collection | its own views, and tabs from outside (marked ↗) | Workouts: All · Calendar · Stats ↗ |
| A global collection | its own views, and tabs from outside (marked ↗) | Health log: Feed · Calendar |
| A hub | any views and entries | Home: Overview · Fitness · This week's tasks · Health log |
Move, rename and remove a tab
- Drag a tab to move it. Press a tab and move the pointer. A line shows where it will land. Let go, and the new order is saved. Press Esc while you drag to cancel. Example: drag “Health log” in Home to the left of “Fitness”.
- Click the tab you are on to open its menu: Rename, Move left, Move right, and the rest. On a phone, Move left and Move right are how you move a tab.
- Double-click a tab to rename it in place.
- Delete a view has Undo. The toast says “Deleted the view Calendar.” Press Undo, and the view comes back in its old place.
Hubs
A hub is a tab bar of its own, with a name and an icon. It sits in the Hubs part of the sidebar and belongs to no collection. Use it for the things you open most.
Example: the hub Home has four tabs.
| Tab | What it is | Where it lives |
|---|---|---|
| Overview | a dashboard | an entry in Dashboards |
| Fitness | a dashboard | an entry in Dashboards |
| This week’s tasks | a board of Tasks, with the filter “Due this week” | a view that lives in Home |
| Health log | a feed of the Health log global collection | a view that lives in Home |
The two dashboard tabs show only their Dashboard property: the charts, at full width.
The rules
- Make as many as you like. Click + New hub in the sidebar.
- A hub holds no data. Its tabs point to entries, or hold views. So a hub is a
setting, like a view. It is stored in your folder as
Settings/Hubs/Home.json. - You can rename a hub, change its icon, give it a banner, share it, or delete it. A deleted hub goes to the Trash for 30 days, with Undo. Restore it from the Trash, or from the hub’s own page while it is open.
- Hide a hub to take its row out of the sidebar without deleting it: Hide from sidebar in the row’s menu or the page’s ⋯ menu. The Hubs part then shows a quiet 1 hidden hub line; click it to show the hub again. A hidden hub is still in search (Ctrl+K).
- Deleting a hub, or removing a tab, never deletes an entry. Delete Home, and the Overview dashboard stays in Dashboards.
- Hubs do not nest. A hub is never a tab, and never a block.
- The hub page is the screen of a hub, like the collection page is the screen of a collection: the header row (the breadcrumb and the ⋯ menu), then a banner, the icon and name, and the tab bar.
- Search finds hubs. Type a hub’s name in search (Ctrl+K) and pick it: the hub opens.
Home, the hub you start with
- The first time you start the app, the sidebar has one hub: Home. Its first tab is a starter dashboard called Overview, an entry in Dashboards.
- It is called Home, not “Dashboards”. So the sidebar never shows two rows called Dashboards: the hub and the collection. You can rename it to “Dashboards” in one click.
- Overview is the real dashboard. Its tab shows the dashboard’s Dashboard property. The name shows once: the tab is the only “Overview” on the page. The dashboard’s menu (Edit layout, Add widget, Board settings…) is at the top of the tab’s own menu, so you add, move and resize charts right in the tab. The same dashboard opens from Dashboards in the sidebar, with its title above the Dashboard property.
- Moving from the old Kaizendex: your old default dashboard is Home’s first tab, in place of Overview. See Dashboards from the old app.
- If you do not want Home, remove its row from the sidebar, or delete the hub. Nothing else changes. Removing a sidebar row never deletes the thing it points to.
- A new window tab (+ in the top bar, or
Ctrl+T) opens on Home. Without a Home hub, it opens on your first hub, or on your collections when you have no hub. - Which hub the bottom tab bar on a phone opens is not decided yet.
See What you start with.
Share a hub
There are two ways to share a hub. They give very different things.
| You | They get | Example |
|---|---|---|
| Share it with a person | your real hub: every tab, with your data. It is like giving them a key. | Your coach Jonas opens your “Training” hub and sees your workouts. |
| Publish it to the Library | a setup, never your data. Their copy shows their data. | Mia copies your “Training” hub. Its tabs show Mia’s workouts. |
Share with a person uses the normal sharing: the Share & privacy panel, a shared space, and the owner’s plan pays. The collections and entries that the tabs show join the share. Before you share, the app lists everything the person will be able to see: “Workouts, Sleep, the Fitness dashboard, My training notes”. So nothing goes out by surprise. See Share with people.
Publish to the Library never sends an entry of yours:
| Part of the hub | In the published hub |
|---|---|
| Its name, icon and quick options | come along |
| A view tab | comes along as a setup. In the copy, it shows the new owner’s data. |
| A dashboard tab | its layout comes along: its Chart, View and HTML blocks, as a preset of the Dashboards collection. The copy makes a new dashboard from it, with the new owner’s data. The dashboard’s text, photos and Entry blocks stay behind. |
| A tab that shows another entry (a note, any entry) | stays behind |
Before you publish, the app lists what goes out and what stays behind. See Publish to the Library.
A view lives where you made it
- A view you make in a hub lives in that hub. It does not show up in the collection’s own tabs. This works like a linked view in Notion.
- A collection’s own views are the tabs of its collection page. They are stored with the
collection, in its
_collection.jsonfile.
Example: you make “This week’s tasks” in Home. It reads the Tasks collection. The Tasks collection page does not get a new tab.
- The view’s own settings (filter, sort, group, what cards show) are saved in the hub, so they change nothing on the collection page.
- A view that lives in a hub lives nowhere else. So its tab’s menu says Delete view, not “Remove tab”. The toast offers Undo. The entries it showed stay.
- In its tab’s menu, Open Tasks opens the collection it reads.
Add existing
Add existing… makes a tab that points to something that already lives somewhere else: an entry, or a view from another tab bar.
- Example: in Home, add the Workouts “Calendar” view. Home gets a Calendar tab. The view still lives in Workouts. It is the same view, not a copy.
- When you add an entry, the tab shows what its collection sets for tabs. Change it with Show in the tab’s menu.
- If that thing is deleted, its tab goes away too.
The + menu
Click + at the end of any tab bar. In a hub, the menu looks like this:
+ New dashboard New view New global view ───────────── Add existing… a dashboard, a note, any entry, or a view from another place Edit this menu…The quick options sit at the top. Each one makes either a new entry in a collection, or a new view.
- New dashboard makes a new entry in Dashboards and opens it as a tab. The tab shows its Dashboard property.
- New view asks which collection it reads, then the view type (table, board, calendar…). In a collection’s tab bar, it reads that collection without asking.
- New global view asks which global collection it reads.
The labels use what one entry is called in that collection: one entry of Dashboards is a “dashboard”, so the option says New dashboard. See What one entry is called.
What we set up
We set up the quick options for you, the same way we make Notes and Dashboards for you.
| Tab bar | Quick options we set up |
|---|---|
| A hub | New dashboard · New view · New global view |
| A collection (Workouts) | New view (of Workouts) · New dashboard |
| A global collection | New view (of it) · New dashboard |
Edit this menu
Edit this menu… changes the quick options of that one tab bar.
- A quick option is either “a new entry in a collection”, with a label and an icon, or “a new view” or “a new global view”. Nothing is hardcoded.
- Example: add New note to Home, or New project to a Work hub.
- If you delete the Dashboards collection, New dashboard goes away from every menu.
Tabs from outside: the link mark
In a collection’s tab bar, the first quick option makes a view of that collection, because that is what you expect there. You can also add a dashboard, a view of another collection, or a global view.
- Such a tab gets a small link mark (↗). Its tooltip says where the thing lives: “From Dashboards”, “From Sleep”.
- Example: Workouts has the tabs
All · Calendar · Stats ↗. All and Calendar are Workouts’ own views. Stats is a dashboard from Dashboards. - A global collection’s tab bar works the same way.
- Hubs show no link marks. Nothing in a hub belongs to it, so there is nothing to mark.
Icon and name
One control sets the icon and the name, everywhere a thing has a name: an entry title, a tab, a sidebar row, a hub, a collection.
- You set the icon and the name.
- You choose what shows: icon and name, icon only or name only. The title on an entry page always shows its name.
- A tab or a sidebar row takes its name and icon from what it shows, live. Rename the “Fitness” dashboard to “Training”, and its tab says “Training” too.
- If you give a tab its own name or icon, it keeps yours.
Long tab names
When the tabs do not fit, the bar makes room before it cuts anything:
- The tabs shrink to a minimum width.
- Then the extra tabs move into a More ▾ menu at the end of the bar. The tab you are on always stays visible.
- A name that still does not fit is cut at the end with “…”. Hover it to see the full name, or press and hold it on a phone.
- When even the tab you are on has no room, every tab moves into the one menu. The menu then carries the name of the tab you are on: Board ▾.
Nothing in the bar ever paints over something else. A view’s own toolbar (filter, sort, search, New) moves under the tabs when the row is too narrow for both.
Your theme can change this: the tabs can scroll, or wrap onto two rows. See When text is too long.