Skip to content

When text is too long

When a name does not fit, the app first makes room for it. It cuts the text only as the last step. Eight rules decide how. They are the same on every screen, and your theme can change them.

The eight rules

# Rule Example
1 Fit first, cut last tabs shrink, then move into More ▾
2 Content wraps; labels cut an entry title wraps; the same title in a table cell is cut
3 Cut at a whole word Weekly review of my…, not Weekly review of my ru…
4 Cut the part that matters least New Very long collection na… entry
5 Numbers are never cut 12.4k, never 12,4…
6 The full text is one step away a tooltip, a long press, a screen reader
7 No jumps a label never changes size after it shows
8 You control it in the theme the truncate and overflow settings

1. Fit first, cut last

A label uses all the room it has before the app cuts it.

  • Tabs shrink to a minimum width. If they still do not fit, the extra tabs move into a More ▾ menu at the end of the bar. The current tab always stays in view.
  • A sidebar row hides its count and its menu (⋯) before it cuts its name.
The Home hub’s tab bar at three widths. Wide: all five tabs show in full. Narrower: the tabs shrink to their minimum width, and “This week’s tasks” is cut to “This week’s…”. Narrowest: “This week’s tasks” and “Reading list” move into the More menu. Health log, the current tab, stays in the bar.Wide: every tab shows in fullOverviewFitnessThis week’s tasksHealth logReading list+Narrower: tabs shrink to their minimum width, then a long name is cutOverviewFitnessThis week’s…Health logReading list+Narrowest: extra tabs move into More ▾; the current tab staysOverviewFitnessHealth logMore ▾+This week’s tasksReading list
The Home hub’s tab bar as the window gets narrower. Health log is the current tab, so it never moves into More ▾.

Example. A sidebar row reads Books I want to read 48 ⋯. In a narrow sidebar, the count and the menu go first: Books I want to read. Only then is the name cut: Books I want….

2. Content wraps; labels cut

  • Content is text you read: an entry page’s title and the text in a Block page. It wraps onto more lines. It is never cut.
  • Labels are names on one line: tabs, sidebar rows, chips, buttons, table cells, menu items and breadcrumb items. They are cut at the end, with “…”.
  • Card titles sit between the two. They wrap up to a number of lines, then they are cut. The number of lines is a card setting.

Example. The task “Plan the 10 km race in Vilnius on 14 June” shows its whole title on its entry page, on two lines. In a Tasks table, the Title cell shows Plan the 10 km race in….

3. Cut at a whole word

The cut falls between two words when that keeps most of the room. If it would leave too much empty space, the cut falls inside a word.

Example. A tab for the view “Weekly review of my running plan” shows Weekly review of my…, not Weekly review of my ru…. A tab for the note “Electroencephalography results” shows Electroencepha…, because not even the first word fits.

4. Cut the part that matters least

Some labels have a part that matters more than the rest. The app keeps that part and cuts another one.

Label What stays Example
A label the app makes, such as a + button the verb and the kind of thing New Very long collection na… entry
The breadcrumb the collection, the first and the nearest Parent, and the page; the Parents between fold into … 📝 Notes / Areas / … / Side projects / Income School
A file name or an id the start and the end; the cut is in the middle 2026-10-08 …77ab.md
A search result the words that match your search …along the river. Knee was fine…

Example: a label the app makes. Your collection is called “Very long collection name for side projects”. You did not say what one entry is called. So its + button reads New Very long collection na… entry: “New” and “entry” stay, and the name is cut. Set One entry is called to “project”, and the button reads New project. See Settings.

Example: the breadcrumb. The note “Income School” sits inside “Side projects”, inside “Work”, inside “Areas”. The full path is 📝 Notes / Areas / Work / Side projects / Income School. With more than two Parents, it shows 📝 Notes / Areas / … / Side projects / Income School, and the … says 1 more. Each name is also cut with “…” past its width: 160 px for a Parent, 240 px for the page.

Example: a file name. The file 2026-10-08 01929c4e77ab.md shows as 2026-10-08 …77ab.md. You still see the date and the end of the id.

5. Numbers are never cut

A cut number tells a lie: 12,4… can be 12,400 or 12,400,000. So a number that does not fit uses its short form, if its format allows one. If its format has no short form, its column grows.

Example. A narrow Steps column shows 12,431 as 12.4k.

6. The full text is one step away

Every cut label keeps its full text:

  • On a computer, hover over the label. A tooltip shows the full text.
  • On a phone, press and hold the label.
  • A screen reader always reads the full name.

7. No jumps

The app works out the cut from the space it has, before it paints the label. So a label never shows in full first and then shrinks. It never changes size after it shows. This follows the instant rule.

8. Change it in your theme

The built-in theme follows these rules. You can change them in your theme. Every label tag has the settings. A label tag is a name tag that shows a name or a short text: a tab, a sidebar row, a chip, a button, a table cell, a menu item, a breadcrumb item, a card title, and the label tag itself.

Setting What it does Values
truncate.lines how many lines the text may take before it is cut 1 to 6
truncate.cut where the text is cut end · middle · start · none
truncate.minWidth the narrowest the label may get before it is cut pixels (80) or characters ("6ch", six characters wide)
truncate.marker the sign that shows the cut "…" by default
overflow (only on the tab bar, tabs.bar) what happens when the tabs do not fit menu · scroll · wrap
cut Keeps Example
end the start Weekly review of my…
middle the start and the end 2026-10-08 …77ab.md
start the end …my running plan
none everything: the label is never cut Weekly review of my running plan
overflow When the tabs do not fit
menu (default) the extra tabs move into More ▾
scroll the tab bar scrolls sideways
wrap the tabs take two rows

Example. This theme keeps tabs on one line. They shrink to six characters wide, and then they move into More ▾. Sidebar names may take two lines before they are cut. Chips keep the start and the end of their text.

{
"parts": {
"tabs.bar": {
"truncate": { "lines": 1, "cut": "end", "minWidth": "6ch" },
"overflow": "menu"
},
"sidebar.row": { "truncate": { "lines": 2 } },
"chip": { "truncate": { "cut": "middle" } }
}
}

A theme stores only what you change, so most themes hold none of this. Like any part setting, you can also set it for one collection or one view. See Where a design applies.